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

VS Code · Lead Gen

How to Use LeadOcean professional search in VS Code

Returns professional records with names, headlines, current roles, employers, locations and contact availability flags. Use it to find relevant business roles at target companies before requesting individual profiles or contact details.

Prompts to try with LeadOcean professional search in VS Code

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

Use LeadOcean professional search to retrieve up to five public executive records at microsoft.com. Add their names, titles, employers and reported locations to the project's company research page.

LeadOcean professional searchVS Code
Try asking
  • Use LeadOcean professional search to retrieve up to five public leadership records at salesforce.com with chief executive titles. Create a table in the project showing the returned names, titles and employers.

  • Use LeadOcean professional search to retrieve up to five public executive records at adobe.com. Update the project's research view to show headline, current role and company.

  • Use LeadOcean professional search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from LeadOcean professional search and tell me what changed since last week.

How to set up LeadOcean professional search in VS Code

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

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to VS Code on the console's Agents & MCP page, or run:

    code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
  2. Sign in

    VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

Use the Spiral skill

  1. Send VS 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 LeadOcean professional 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": "leadocean/people/search",
        "input": {
          "q": "<q>"
        }
      }'

Then paste one of the prompts above: VS Code finds LeadOcean professional search on Spiral, shows the price and runs it.

LeadOcean professional search providers and prices

Spiral runs LeadOcean professional search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
LeadOcean · People search
leadocean/people/search

Settings you can ask for

Ask VS Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Slimon or off

Drop empty and heavy parts of each record. Default false.

Counton or off

Also return meta.total. With limit 1 this is a free sizing call: data is empty and meta.countOnly is true. A larger limit is a paid page plus the total.

Limit1 to 101

Rows to return, from 1 to 10. LeadOcean allows up to 100; this cap keeps a page within 100 Firecrawl credits. Each returned row costs 10 credits. An empty page costs nothing. Omitting it sends 1.

Orderranked or stable

ranked (default) scores the page. stable walks the snapshot in id order. Send the same order on every page.

Facetson or off

Also return counts by seniority, country, industry, and company size.

Has emailon or off

Only people with, or without, a known email.

Has phoneon or off

Only people with, or without, a known phone number.

Reachableany or strict

any: an email or a phone. strict: the email is verified, catch_all_valid, or catch_all.

Max foundeda number

Latest year the company was founded. Records with no figure are left out.

Max fundinga number

Total funding raised, in USD, upper bound. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld.

Min foundeda number

Earliest year the company was founded. Records with no figure are left out.

Min fundinga number

Total funding raised, in USD, lower bound. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld.

Max employeesa number

Company headcount, upper bound. Records with no figure are left out.

Min employeesa number

Company headcount, lower bound. Records with no figure are left out.

Min followersa number

Minimum company LinkedIn followers. 0 means no minimum. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld.

Exclude viewedon or off

Leave out people this account marked viewed. Marking itself is not a capability here.

Facet companieson or off

With facets, also estimate distinct employers in each bucket.

Min connections0 to 500

Minimum LinkedIn connections, from 0 to 500. 0 means no minimum.

Max last funding yeara number

Funded no later than this year. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld.

Min last funding yeara number

Funded no earlier than this year. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld.

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

What can you do with LeadOcean professional search in VS Code?

Build a company research view that shows public leaders' reported titles, employers and available career histories. Map current positions separately from past roles so the interface keeps those two contexts clear.

Prepare a business meeting brief

Find public executives at a target company and summarize their reported roles and employers. Add available career history for the leaders attending the meeting.

Research potential business partners

Identify public partnership leaders at companies such as Microsoft or Salesforce. Use their reported titles and professional backgrounds to prepare questions for a partnership discussion.

Prepare conference speaker research

Find public business leaders with relevant role titles, then summarize available career history and skills for an event team's speaker research.

Build a public executive research brief

Collect reported titles, employers and available career histories for public executives. Organize the results into background notes for business reporting.

Compare leadership roles across companies

Compare the returned titles and employers of public leaders at selected businesses. Use detailed profiles to explain the professional experience behind those roles.

Add context to company research

Supplement a company research brief with its public leadership's reported roles, locations and professional backgrounds. Keep current positions separate from past roles.

Questions about LeadOcean professional search in VS Code

Can VS Code use LeadOcean professional search?

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run LeadOcean professional search like any built-in tool.

How much does LeadOcean professional search cost in VS Code?

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

Do I need an Alexandria account to use LeadOcean professional search in VS Code?

No. Spiral runs LeadOcean professional 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 LeadOcean professional search in VS Code?

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

Does VS Code wait while LeadOcean professional search runs?

LeadOcean professional search runs in the background. VS Code starts the run, checks on it and gives you the json when it's ready.

Does LeadOcean have contact details for every profile?

No. Its November 13, 2026 figures list 996 million people, but only 424 million with an email and 190 million with a phone.

Where does LeadOcean get its data?

LeadOcean says it combines more than 20 licensed and proprietary sources into one schema.

How fresh are LeadOcean records?

Its privacy policy says records are refreshed continuously and removed when a source no longer supports them. That describes the database's maintenance process, rather than a fixed update interval for each profile.

Does an email verification date show exactly when that address was checked?

No. LeadOcean assigns one date to an entire verification batch, so it is not an individual address's verification timestamp.

How complete is the career history?

LeadOcean includes past roles, education, certifications and awards when held. Past employers lack company identifiers, so historical company matches must use names.

Get started

Start using LeadOcean professional search in VS Code

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

Paste this into VS Code:

Set up VS Code

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