Openlead MCP

B2B lead generation and prospecting: find companies like your customers and the people to contact.

Openlead finds companies that fit a description of your ideal customer, or companies like a website's customers, and the right people at each. Searches read the live web and keep the page each company was found on. Results land in your Openlead workspace.

This repo is the install surface for AI agents: the address of the remote MCP server, configs for common clients, plugin manifests for Claude, Cursor, ChatGPT and Codex, and agent skills. The Openlead app itself is not in this repo.

Status: live. Add the address below to your MCP client and sign in with your Openlead account.

The address

https://mcp.openlead.ai

One remote server over Streamable HTTP. There is no key to paste: your client signs in with your Openlead account the first time it connects.

What it does

Ten tools, working in one of your workspaces the way you do in the app. They come in groups: companies, people, contact status, lists and the balance.

Tool	What it does	Cost
`estimate_company_search`	Says what a company search would use before it runs: how many companies, and how many from the month's companies or from credits. Runs no search.	Free
`search_companies`	Finds companies that match a description in plain words, or companies like a website's customers. Optional filters: industry, company size, location, tech stack. Each company comes with a one-sentence reason, its source page and up to 3 people.	Each company new to the workspace uses one of the month's companies, then one credit. Runs only with confirm=true.
`get_company_search`	Reads a search that was still running when it handed back, by its `search_id`.	Free
`list_people`	Lists the people the workspace already has at companies it found, with name, title and company.	Free
`find_people`	Looks people up at companies the workspace has found, by title, seniority, department or location. People come back with name, title and company.	Free
`unlock_people`	Shows a person's profile URL and location. Each person is unlocked once per workspace.	Free for now. Runs only with confirm=true.
`check_contact_status`	Says who the workspace has already contacted or exported, and when.	Free
`save_to_list`	Saves companies or people to a new or existing list.	Free
`export_list`	Gives a download link for a list as a CSV file. Downloading it records the people in it as Exported.	Free
`credit_balance`	Reads the plan, the companies left this month and the credits on top.	Free

A search finds 25 companies unless the agent asks for more, up to 500 or what the balance covers, whichever is less.

What your agent can spend and see

Before a paid search, the agent can read what is left with credit_balance and what the search would use with estimate_company_search. Both are free.
The tools that can spend, search_companies and unlock_people, spend nothing unless the agent calls them with confirm=true. Without it they answer with what the call would use.
Estimating or reading a search, listing and finding people, checking contact status, saving to a list, exporting a list and reading the balance are free.
The agent works in the one workspace the member picked when connecting. It sees no other workspace.
The member can revoke a connected agent at any time, under Connected agents in the workspace. A revoked agent stops on its next call.
There are ten tools and no API keys. Spending comes from the plan's monthly companies and credits, as in the app.

For agents: ask the member before any call with confirm=true. Use only the tools the server lists. Do not state a tool, a price, or that the server is live, unless the server or openlead.ai says so.

Set it up

Cursor

Put this in ~/.cursor/mcp.json, or use the Add to Cursor button on openlead.ai/mcp:

{
  "mcpServers": {
    "openlead": { "url": "https://mcp.openlead.ai" }
  }
}

Claude Code

claude mcp add --transport http openlead https://mcp.openlead.ai

Then type /mcp in Claude Code and choose openlead to sign in.

Claude on the web and the desktop app

Open Customize, then Connectors.
Choose Add custom connector.
Paste https://mcp.openlead.ai and choose Add.

On a Team or Enterprise plan, an owner adds the connector under Organization settings first.

VS Code

Put this in .vscode/mcp.json, or use the Add to VS Code button on openlead.ai/mcp:

{
  "servers": {
    "openlead": { "type": "http", "url": "https://mcp.openlead.ai" }
  }
}

Codex

Run these in a terminal. The second opens the browser to sign in:

codex mcp add openlead --url https://mcp.openlead.ai
codex mcp login openlead

The Codex CLI and IDE extension read the same configuration. To write it by hand instead, see examples/codex-config.toml.

Other clients

Any client that speaks Streamable HTTP and signs in with OAuth can connect. Clients that read a JSON config take this one:

{
  "mcpServers": {
    "openlead": { "type": "http", "url": "https://mcp.openlead.ai" }
  }
}

The same configs are in examples/.

Sign in

The first time your client calls Openlead, it opens a page in your browser:

Sign in with the six-digit code or the sign-in link Openlead emails you. There is no password.
Pick the one workspace this agent may use.
Choose Allow access. Your client finishes connecting by itself.

No account yet? Creating one is the same emailed code. The Free plan includes 50 companies a month with no card.

What it costs

Nothing on top of your plan. Your agent spends the same monthly companies and credits as the app. The balance belongs to your organization and is shared by all of its workspaces.

Plan	Companies a month	Paid monthly
Free	50	$0
Solo Founder	300	$35
Early Stage	1,500	$149
Large Scale Outreach	10,000	$699

Yearly prices and credit packs are on the pricing page.

Limits

Each connected agent can make 30 calls a minute, with one search or people lookup running at a time. A search still running after about 50 seconds hands back the companies found so far and a search_id; reading it back with get_company_search is free.

Agent skills

The skills tell an agent when to use Openlead, which tool to call for what, and what not to invent. There is one per job.

Skill	The job
`openlead`	Find B2B leads: the whole flow, and which skill fits which request
`openlead-build-lead-list`	A lead list from a description of your ideal customer, with an estimate first
`openlead-lookalike-companies`	Companies like your customers, from a website or a description
`openlead-find-decision-makers`	Who to contact at the companies you found, and unlocking their details
`openlead-check-before-outreach`	Who was already contacted or exported
`openlead-save-and-export`	Saving to a list, or a CSV file of a list
`openlead-balance-and-costs`	What is left to spend, and what a search would use
`openlead-setup`	Connecting, sign-in, costs, and what Openlead does not do

npx skills add openlead-ai/openlead-mcp

As a plugin

This repo is also a plugin: the server and the skills in one install.

Claude and Claude Code read .claude-plugin/plugin.json, .mcp.json and skills/.
Cursor reads .cursor-plugin/plugin.json, the .mcp.json it names, and skills/.
ChatGPT, Codex and other clients of the Agent Plugins format read plugin.json, mcp.json and skills/. ChatGPT and Codex take the listing from .codex-plugin/plugin.json.
Codex can add this repo as a plugin marketplace, from .agents/plugins/marketplace.json: codex plugin marketplace add openlead-ai/openlead-mcp.
Grok Build and clients that follow the same layout read .mcp.json and skills/.

Example asks

"Find companies like the customers of timly.com. Tell me what it would cost before you run it."
"Find B2B SaaS companies in Berlin that sell to small businesses, then the founders at each."
"Which of these people has my workspace already contacted? Save the rest to a list called Berlin SaaS."
"How many companies do we have left this month?"

What it does not do

It does not send emails, sync a CRM, or return email addresses or phone numbers.

No API keys. Agents sign in with an Openlead account.
No reading of your inbox or CRM. Contact status is what Openlead records: people a member marked contacted, and people exported in a CSV file.

License

MIT for what is in this repo: the README, the configs, the plugin manifests and the skills. The Openlead product and its code are not part of it.

openlead

Documentation