[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Prospeo people search](https://spiral.ai/integrations/gemini-cli/prospeo-people-search)

# How to Use Prospeo people search in Gemini CLI

Retrieve professional records and employer data from Prospeo, with up to 25 results per page. Use it to discover business records before enrichment; search results do not reveal email addresses or mobile numbers.

|  |  |
| --- | --- |
| Model | Prospeo people search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.0261885 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Prospeo people search in Gemini CLI

- Use Prospeo people search to retrieve page 1, then build a local table of the employer names and websites represented in that sample.
- Use Prospeo people search to retrieve pages 1 through 3, then summarize the returned company industries in a project report without listing individual contact details.
- Use Prospeo people search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Prospeo people search and tell me what changed since last week.
- Check Prospeo people search and summarize what you find in three bullet points.

## How to set up Prospeo people search in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Prospeo people search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "prospeo/people/search",
    "input": {
      "filters": {}
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Prospeo people search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Prospeo people search tools and prices

- [Prospeo · People search](https://spiral.ai/tools/alexandria/prospeo/people/search) (Alexandria): Up to $0.0261885 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 1000 | — | Page number, 1 to 1,000. 25 results per page. Prospeo's default is 1. |

## What can you do with Prospeo people search in Gemini CLI?

Build an internal partnership research view from Prospeo business records. A coding agent can turn returned professional context, company details, or verified work emails into reviewable project data.

### Prepare partnership invitations

Review returned business records for relevant companies, inspect a shortlisted public founder's professional context, and retrieve a verified work email for an internal partnership invitation list.

### Build a business podcast guest shortlist

Use returned employer information to identify companies worth considering, review public executives' professional records, and find work emails for guest invitations.

### Prepare founder roundtable invitations

Review companies represented in search results, add professional context for public founders selected by the event team, and retrieve verified work emails for invitations.

### Complete internal business relationship records

Match returned business records against an internal company shortlist, enrich selected public executives, and fill verified work email gaps for partnership coordination.

### Compare company context in a sample

Summarize the employer websites and industries represented in retrieved records. Enrich known public executives when the team needs more context about a particular business.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Prospeo people search in other agents

- [Amp](https://spiral.ai/integrations/amp/prospeo-people-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/prospeo-people-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/prospeo-people-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/prospeo-people-search)
- [Cline](https://spiral.ai/integrations/cline/prospeo-people-search)
- [Codex](https://spiral.ai/integrations/codex/prospeo-people-search)
- [Cursor](https://spiral.ai/integrations/cursor/prospeo-people-search)
- [Devin](https://spiral.ai/integrations/devin/prospeo-people-search)
- [dots](https://spiral.ai/integrations/dots/prospeo-people-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/prospeo-people-search)
- [Gemini](https://spiral.ai/integrations/gemini/prospeo-people-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/prospeo-people-search)
- [goose](https://spiral.ai/integrations/goose/prospeo-people-search)
- [Grok](https://spiral.ai/integrations/grok/prospeo-people-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/prospeo-people-search)
- [Hermes](https://spiral.ai/integrations/hermes/prospeo-people-search)
- [Instinct](https://spiral.ai/integrations/instinct/prospeo-people-search)
- [Manus](https://spiral.ai/integrations/manus/prospeo-people-search)
- [Muse](https://spiral.ai/integrations/muse/prospeo-people-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/prospeo-people-search)
- [n8n](https://spiral.ai/integrations/n8n/prospeo-people-search)
- [Notion](https://spiral.ai/integrations/notion/prospeo-people-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/prospeo-people-search)
- [opencode](https://spiral.ai/integrations/opencode/prospeo-people-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/prospeo-people-search)
- [Raycast](https://spiral.ai/integrations/raycast/prospeo-people-search)
- [VS Code](https://spiral.ai/integrations/vscode/prospeo-people-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/prospeo-people-search)
- [Zapier](https://spiral.ai/integrations/zapier/prospeo-people-search)

## More Gemini CLI guides

- [Prospeo company search](https://spiral.ai/integrations/gemini-cli/prospeo-company-search)
- [Prospeo professional profile](https://spiral.ai/integrations/gemini-cli/prospeo-professional-profile)
- [Prospeo company details](https://spiral.ai/integrations/gemini-cli/prospeo-company-details)
- [Prospeo work email lookup](https://spiral.ai/integrations/gemini-cli/prospeo-work-email-lookup)
- [PredictLeads similar companies](https://spiral.ai/integrations/gemini-cli/predictleads-similar-companies)
- [QuickEnrich business contact search](https://spiral.ai/integrations/gemini-cli/quickenrich-business-contact-search)

## Questions about Prospeo people search in Gemini CLI

**Can Gemini CLI use Prospeo people search?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Prospeo people search like any built-in tool.

**How much does Prospeo people search cost in Gemini CLI?**

Up to $0.0261885 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use Prospeo people search in Gemini CLI?**

No. Spiral runs Prospeo people search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Prospeo people search in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Prospeo people search runs?**

Prospeo people search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does Prospeo always return a complete professional record?**

No. Prospeo documents that any professional-record property can be null when data is unavailable, including entire nested sections.

**What business context does Prospeo provide?**

Professional records can include a headline describing the person's current role and expertise. Matched employer data can include the company's main website and industry.

**Does searching Prospeo reveal contact details?**

People search does not reveal email addresses or mobile numbers. Email retrieval requires enrichment or a work email lookup.

**How many records can a Prospeo search return?**

Prospeo documents 25 results per page and a retrieval ceiling of 1,000 pages, or 25,000 records.

**Can Prospeo return only verified work emails?**

Yes. Prospeo supports requiring a verified email before returning a matched record; the work email lookup uses that requirement.

