Claude skill

Lead List Builder

Describe your ideal customer. Get a sized, filtered list of people, with the count shown before a single record is spent.

Get your free API key →Free to start. No credit card. 1,000 records to spend whenever you like.

Lead List Builder is a Claude skill that turns a plain description of your ideal customer into a filtered list of people. It sizes the list first, which is free, and pulls it only after you say yes.

What it does

You tell Claude who you want: "VPs of Sales at US software companies with 51 to 200 employees". The skill maps that to LeadOcean's exact filter values, counts the matches, and shows you the number.

Then it asks before it spends anything. Up to 100 people come back through the search tool. Larger lists run as a bulk export, and you get a download link.

Work emails are opt-in. The search tool never returns addresses, so the skill reveals them only for the first 10 people, and only when you ask.

It runs on the LeadOcean MCP server. There is no API key to paste. You sign in once with OAuth.

How it works

The skill is a SKILL.md file. It tells Claude which tools to call and in what order.

  1. get_account reads your records remaining. Free.
  2. list_enum_values resolves job level, job function, country, industry and headcount to exact strings. Free. list_filters is called only for a filter the skill does not recognise. Free.
  3. count_leads sizes the list. It counts mailable people by default. Free.
  4. Claude shows the filters and the count, and waits for your yes. No tool call.
  5. search_leads pulls up to 100 people. 1 record per person returned.
  6. For more than 100 people, export_leads starts a bulk CSV instead. 1 record per row. get_export then polls until the file is ready. Free.
  7. get_lead with reveal_email: true runs only if you ask for emails. 1 record per person.

How to use it

  1. Download the zip: Download lead-list-builder.zip.
  2. Unzip it and add the lead-list-builder folder as a skill in Claude.
  3. Connect LeadOcean at https://api.leadocean.io/mcp and sign in.
  4. Ask: "Build a lead list of VPs of Sales at US software companies, 51 to 200 employees". Add a size if you want one: "Pull 200".

You need a LeadOcean account. The free plan gives you 1,000 records, one-off, no card.

Sample output

The sizing step is free, so we ran it. On 1 October 2026 count_leads took these filters and returned 49 mailable people.

FilterValue
jobLevelVP
jobFunctionSales & Business Development
countryUS
employeeRange51-200
industryComputer Software
Mailable people (verified, catch_all_valid, catch_all)49
Records spent0
Date1 October 2026

list_enum_values with name: "job_level" returned six exact values: C-Team, Director, Manager, Other, Staff and VP. That is why the skill resolves values before it counts.

The pull itself spends records, so no real list is pasted here. This is the shape of the reply, with placeholder values.

Output format (placeholder values)

code
Lead list: VPs of Sales, US software, 51-200 employees
As of 1 October 2026

Filters:
jobLevel: VP
jobFunction: Sales & Business Development
country: US
industry: Computer Software
employeeRange: 51-200
Mailable people matching: 49
Pulled: 49

| Name | Title | Company | Domain | Country | Email status | LinkedIn |
| Jane Doe | VP Sales | Acme | acme.com | US | verified | https://www.linkedin.com/in/janedoe |

Work emails (only if requested)
| Name | Work email | Email status |
| Jane Doe | jane@acme.com | verified |

Records spent: 49

The skill replies in this shape and nothing else. The title line is a Markdown H1. For an export, the table is replaced by one line with the export name and the download link. Any field it cannot find reads "not on file".

Records per run

StepToolRecords
Check the accountget_account0
Resolve filter valueslist_enum_values0
Size the listcount_leads0
Pull up to 100 peoplesearch_leads1 per person
Or export more than 100export_leads1 per row
Poll the exportget_export0
Emails, on request (first 10)get_leadup to 10
Total, default run50

The free plan's 1,000 records cover 20 default runs. On Pro ($499 a month) there is no per-record price. Fair use applies, as described on the pricing page.

Background reading: what a lead list is, the best lead list building tools and how to build a lead list in Windsurf.

FAQ

How big a list can it build?

Up to 100 people in one search run. Above that it starts an export, which takes up to 50,000 rows per request. The skill quotes the record cost and waits for your yes before either one.

Does the list include emails?

Not by default. The search tool returns an email status flag, not the address. Ask for emails and the skill reveals them for the first 10 people. For a full list with email columns, use the Exports page in the app at app.leadocean.io, which shows the price before you download.

Why does the count look smaller than I expected?

count_leads counts mailable people only: verified, catch_all_valid and catch_all. People with no usable email are left out, and so are people whose company headcount or funding is not on file when you filter on it.

Build your first lead list for free

Free to start. No credit card. 1,000 records to spend whenever you like.

Get your free API key →