[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Prospeo people search](https://spiral.ai/integrations/opencode/prospeo-people-search)

# How to Use Prospeo people search in opencode

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 opencode

- 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 opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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: opencode finds Prospeo people search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## 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 opencode?

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 opencode guides](https://spiral.ai/integrations/opencode)

## 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)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/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)
- [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 opencode guides

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

## Questions about Prospeo people search in opencode

**Can opencode use Prospeo people search?**

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

**How much does Prospeo people search cost in opencode?**

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 opencode plan is separate.

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

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 opencode?**

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

**Does opencode wait while Prospeo people search runs?**

Prospeo people search runs in the background. opencode 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.

