Pre-Black Friday: 20% off, for as long as you stayEARLYBFon Solo and AgencyEnds Nov 28Start free

MCP setup

Connect LeadOcean to ChatGPT

On the web, one URL and an OAuth sign-in. In the desktop app, one URL and your API key in a header. The free plan gets the same MCP server as Agency.

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

Add LeadOcean to ChatGPT, paste one URL, and ChatGPT can count, search and enrich people and companies. There are two ways in, and they connect to the same server:

  • ChatGPT on the web signs in with OAuth. No API key is pasted anywhere.
  • The ChatGPT desktop app has no sign-in option for a custom MCP server, so it sends your LeadOcean API key in a header instead.

The free plan gets the same server as Agency. This page covers ChatGPT only. Codex has its own page, and other clients are on the MCP hub.

Before you start

You need a LeadOcean account and either ChatGPT on the web or the ChatGPT desktop app. Create a free LeadOcean account: no card, 1,000 records for life, work email required.

ChatGPT adds remote MCP servers as plugins. OpenAI's guide to adding a custom MCP server, October 2026, says to use ChatGPT on the web and that workspace permissions apply. It does not list which plans can add one. On a Business or Enterprise workspace, an admin may have to allow custom MCP servers first, so ask yours if the option is missing.

Earlier, ChatGPT required a Developer mode switch before this step. OpenAI's current guides do not mention it. If the option is missing on your account, check Settings, then Security and login.

ChatGPT on the web

The server URL is https://api.leadocean.io/mcp. It speaks streaming HTTP, which ChatGPT supports. These are the steps from OpenAI's guide to connecting a plugin, October 2026:

  1. Go to ChatGPT Plugins at chatgpt.com/plugins.
  2. Select the plus button, then choose Add custom MCP server.
  3. Enter a name, such as LeadOcean, and a short description.
  4. Under Connection, enter the server URL https://api.leadocean.io/mcp.
  5. Set authentication to OAuth. Leave client credentials empty.
  6. Read the risk warning and select I understand and want to continue.
  7. Select Create as a plugin, then review the 15 tools ChatGPT found on the server.

The plugin then sits in your personal plugins, or in the workspace you created it in. Install it before you use it in a chat.

Sign in

Sign-in is OAuth 2.1 in a browser window. When ChatGPT asks you to connect, sign in to LeadOcean, approve, and return to ChatGPT.

You do not register an OAuth client by hand. With no client credentials entered, ChatGPT can use dynamic client registration, and the LeadOcean OAuth server supports it at https://api.leadocean.io/oauth/register (scope mcp).

To revoke, uninstall the plugin in ChatGPT, or remove the app under API keys, Connected apps in your LeadOcean account.

ChatGPT desktop app

The desktop app adds a custom MCP server under Settings → Plugins → MCPs. That screen takes a URL and fixed headers, with no OAuth option, so you send a LeadOcean API key as the bearer token:

  1. In LeadOcean, open API keys and create a key just for ChatGPT, so you can pause or revoke it on its own.
  2. In the ChatGPT desktop app, open Settings → Plugins → MCPs, then Add, then Connect to a custom MCP.
  3. Enter the name LeadOcean and choose the type Streamable HTTP.
  4. Enter the URL https://api.leadocean.io/mcp.
  5. Under Headers, add the key Authorization with the value Bearer followed by your API key.
  6. Select Save, then switch LeadOcean on in the MCPs list.

The key spends the same records as the API and keeps its own limits, so a paused or revoked key stops ChatGPT straight away. Do not paste the key into a chat message. It belongs in the header only.

Your first prompt

Start with a count. Counting is free. In a new chat, type @ in the prompt box and select the LeadOcean plugin. Then send:

Use the LeadOcean plugin only. How many VP-level sales leaders in the US can I email? Count only. Do not pull anyone.

ChatGPT calls leadocean_count_leads with jobLevel set to VP, jobFunction set to Sales & Business Development and country set to US. That costs 0 records. We ran the same filters on 2026-10-01 and the tool returned 115,336, flagged exact.

That is the tool's default email filter: status verified, catch_all_valid or catch_all. It is not everyone we hold for those filters.

Naming the plugin and the tool follows OpenAI's own advice: say which app and tool to use, and tell the model to avoid other tools. When the count looks right, ask for five people with title and company. That calls leadocean_search_leads at 1 record per person, so 5. For a full sizing run, see size your TAM in ChatGPT.

The 15 tools

ChatGPT lists them as leadocean_ plus the name below. Nine of them spend no records.

ToolWhat it doesRecords
leadocean_count_leadsCounts people for a filter set.Free
leadocean_count_companiesCounts companies for a filter set, with breakdowns by industry, size, HQ country, HQ state and NAICS.Free
leadocean_list_filtersLists valid filters and enum values.Free
leadocean_list_enum_valuesLooks up exact strings, such as one of 534 industries.Free
leadocean_get_accountShows plan, records left and export ceilings.Free
leadocean_get_exportPolls one export for status and download link.Free
leadocean_list_exportsLists your exports.Free
leadocean_mark_viewedRemembers people as already shown, so later searches, counts and exports can leave them out.Free
leadocean_clear_viewedRemoves people from a viewed list, or clears the list.Free
leadocean_search_leadsFinds people by title, level, country, domain and more.1 per person returned
leadocean_get_leadEnriches one person by LinkedIn URL, email or person_id.1
leadocean_find_phoneReturns the phone numbers held for one person.1
leadocean_get_companyEnriches one company by domain or LinkedIn URL.1
leadocean_search_companiesFinds companies by industry, size, funding or technology.1 per company returned
leadocean_export_leadsStarts a bulk CSV export of people.1 per row

A leadocean_get_lead call that finds nobody costs nothing. Source: LeadOcean MCP docs, September 2026.

Troubleshooting

SymptomCauseFix
No Add custom MCP server optionYou are not on the web, or your workspace does not allow custom MCP servers.Use chatgpt.com in a browser. On a workspace plan, ask your admin.
No OAuth option in the desktop appThe desktop app's custom MCP screen takes headers only.Add the Authorization: Bearer <your API key> header, as in the desktop app steps.
401 in the desktop appThe key is wrong, revoked or paused, or Bearer is missing before it.Check the key under API keys and re-enter the header value as Bearer lo_live_….
ChatGPT cannot reach the serverWrong URL, or a typo in the path.Re-enter https://api.leadocean.io/mcp exactly.
OAuth window closed, plugin not connectedYou closed sign-in before approving.Open the plugin and connect again.
Tools missing or staleChatGPT has not pulled the tool list.Refresh the plugin on its details page to pull the 15 tools again.
ChatGPT browses the web insteadIt chose a built-in tool.Select the plugin with @, say "Use the LeadOcean plugin only" and name the tool.
402Your 1,000 free records are spent, or an export needs more than you have left.Check leadocean_get_account. Move to Agency at $497 a month, or shrink the limit.
429Past your plan's rate limit (5 a second on Free, 200 on Agency), or an export ceiling.Wait a second and retry, or ask for smaller batches.
Wrong enum, filter rejectedA value is not in the catalogue, such as an invented industry.Have ChatGPT call leadocean_list_enum_values and use the exact string.

FAQ

Do I need an API key for ChatGPT?

On the web, no: ChatGPT signs in with OAuth. In the desktop app, yes: it sends your API key as a bearer token, because its custom MCP screen has no sign-in. Both spend the same records from one balance as the REST API.

Is the free plan the same server as Agency?

Yes. Free is 1,000 records, one-off, with search and enrich both available. Agency is $497 a month, flat, with no per-record price.

Will ChatGPT ask me to confirm tool calls?

Possibly. OpenAI treats any tool without a readOnlyHint annotation as a write action and asks first. Check the filters and limit, then approve. You can remember the choice for a tool within one conversation; a new conversation asks again.

Connect ChatGPT to 996M people, free

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

Get your free API key →