[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Leadsforge business contact search](https://spiral.ai/integrations/claude-code/leadsforge-business-contact-search)

# How to Use Leadsforge business contact search in Claude Code

Returns matching business contacts and person IDs, without emails or phone numbers. Use it to find relevant public business leaders before choosing whose work email to look up.

|  |  |
| --- | --- |
| Model | Leadsforge business contact search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.013 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Leadsforge business contact search in Claude Code

- Use Leadsforge business contact search to retrieve five C-suite matches at stripe.com, then add the returned data to a local fixture for the executive research view.
- Use Leadsforge business contact search to retrieve public leadership matches at microsoft.com and map the returned person IDs into our existing contact selection component.
- Use Leadsforge business contact search to retrieve five senior marketing matches at hubspot.com, then show the actual returned data in our review screen.
- Use Leadsforge business contact search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Leadsforge business contact search and tell me what changed since last week.

## How to set up Leadsforge business contact search in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Leadsforge business contact 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": "leadsforge/people/search",
    "input": {
      "limit": 10
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Leadsforge business contact search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Leadsforge business contact search tools and prices

- [Leadsforge · People search](https://spiral.ai/tools/alexandria/leadsforge/people/search) (Alexandria): $0.013 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 25 | 10 | People per page, from 1 to 25. Omitted calls request 10. The search is free. |
| cursor |  | — | Opaque cursor from the previous page. |
| companyNames |  | — | Company names to include or exclude. Matching is partial. |
| leadJobTitles |  | — | Job titles to include or exclude. |
| leadLocations |  | — | Person locations to include or exclude. |
| companyDomains |  | — | Company domains to include or exclude: { include: ["stripe.com"], exclude: [] }. |

## What can you do with Leadsforge business contact search in Claude Code?

Build a public executive research feature that returns search matches and work email lookup results separately. Use Leadsforge person IDs to connect selected search results to enrichment in the project's data model.

### Prepare a partnership introduction

Find public business leaders at a prospective partner, select the relevant executive, and look up a work email for an introduction brief.

### Build a conference speaker shortlist

Find public executives at companies relevant to an event's theme, then look up work emails for the speakers selected by the organizer.

### Prepare a podcast guest proposal

Identify public founders or executives at relevant businesses and find a work email for a proposed guest invitation.

### Research business sponsorship contacts

Find public marketing leaders at prospective sponsors and look up work emails for the shortlist approved by the event team.

### Prepare an executive interview request

Find public company leaders relevant to a business publication's interview topic, then look up their work emails for editorial review.

### Complete a business development brief

Search a target company's public leadership roles and add work email lookup results for selected executives to a brief for the account team.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Leadsforge business contact search in other agents

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

## More Claude Code guides

- [LeadOcean work email](https://spiral.ai/integrations/claude-code/leadocean-work-email)
- [Leadsforge similar company preview](https://spiral.ai/integrations/claude-code/leadsforge-similar-company-preview)
- [LeadOcean reverse contact lookup](https://spiral.ai/integrations/claude-code/leadocean-reverse-contact-lookup)
- [Leadsforge similar company search](https://spiral.ai/integrations/claude-code/leadsforge-similar-company-search)
- [LeadOcean professional search](https://spiral.ai/integrations/claude-code/leadocean-professional-search)
- [Leadsforge work email lookup](https://spiral.ai/integrations/claude-code/leadsforge-work-email-lookup)

## Questions about Leadsforge business contact search in Claude Code

**Can Claude Code use Leadsforge business contact search?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Leadsforge business contact search like any built-in tool.

**How much does Leadsforge business contact search cost in Claude Code?**

$0.013 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use Leadsforge business contact search in Claude Code?**

No. Spiral runs Leadsforge business contact 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 Leadsforge business contact search in Claude Code?**

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

**Does Claude Code wait while Leadsforge business contact search runs?**

Leadsforge business contact search runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**How large is Leadsforge's contact database?**

Leadsforge advertises more than 500 million B2B contacts. That describes its business contact database, rather than a count of employees returned for any particular company.

**How fresh is Leadsforge's data?**

Leadsforge says its B2B contacts are refreshed continuously across multiple data sources. That statement describes ongoing database maintenance, rather than a fixed daily or weekly update schedule.

**Where does Leadsforge get its contact data?**

Leadsforge describes a process using more than 20 data sources. When a source lacks the requested data, the lookup continues to another source.

**Does Leadsforge cover every business contact?**

Leadsforge acknowledges that individual providers miss contacts and uses more than 20 sources to improve coverage. Its published database size should not be read as complete coverage of a company's leadership.

**How far can a Leadsforge search be paged?**

The listed search returns up to 25 people per page. Leadsforge's underlying documentation says cursors last 20 minutes after each page and continued pagination stops after 1,000 returned people, so narrower searches are needed for larger audiences.

