Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Lead Gen

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.

Prompts to try with Leadsforge business contact search in Claude Code

Copy an example into Claude Code, or ask in your own words.

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.

Leadsforge business contact searchClaude Code
Try asking
  • 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.

    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.

    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.

    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.

Leadsforge business contact search providers and prices

Spiral runs Leadsforge business contact search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
Leadsforge · People search
leadsforge/people/search

Settings you can ask for

Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 2510

People per page, from 1 to 25. Omitted calls request 10. The search is free.

Max contacts per company1 to 100

Cap how many people one company can fill on the page.

Every API field of Leadsforge · People search is on its tool page: open its card above.

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.

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.

Get started

Start using Leadsforge business contact search in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options