Company Revenue with MCP

Ask Claude or Cursor for a company's annual revenue by domain and the agent calls get_company. One URL, OAuth sign-in, 1 record per lookup.

This page is about setup and prompts. For the field list and what a hit costs in detail, see Company Revenue. Other clients are on the MCP hub.

Connect the server

The server is https://api.leadocean.io/mcp. It signs in with OAuth 2.1, so there is no key to paste. Create a free account first.

Claude Code. The command format is from the Claude Code MCP docs, September 2026:

claude mcp add --transport http leadocean https://api.leadocean.io/mcp
claude mcp login leadocean

Cursor. Add a remote server to mcp.json, in the url form shown in the Cursor MCP docs, September 2026:

{
  "mcpServers": {
    "leadocean": {
      "url": "https://api.leadocean.io/mcp"
    }
  }
}

Cursor starts the sign-in the first time the server is used. Other clients are listed in the LeadOcean MCP docs.

The tool

Revenue has no tool of its own. It comes back from get_company, which the server lists as leadocean_get_company. It costs 1 record per call.

Send one of the two. There is no lookup by company name. The REST twin is POST /v1/companies/enrich.

To find companies by revenue instead, search_companies takes minRevenue and maxRevenue in USD. It costs 1 record per company returned.

Prompts that work

Put a record limit in the prompt. The agent holds a batch to it.

Name the field you want. "Annual revenue" sends the agent to company_revenue_in_usd.

What the agent gets back

The result is one leadocean.company.v1 object plus a meta block. The shape follows the company docs, September 2026, trimmed to the revenue-relevant fields. Every value below is a placeholder (Acme), not a lookup we ran.

{
  "success": true,
  "data": {
    "company_data": {
      "company_name": "Acme",
      "company_domain": "acme.com",
      "company_employees": {
        "number_of_employees": 1200,
        "number_of_employees_code": "1001-5000"
      },
      "company_revenue_in_usd": 250000000
    },
    "company_metrics": { "completion_score": 94, "marketability_score": 81 },
    "meta": { "sources": ["own"], "schema": "leadocean.company.v1" }
  },
  "meta": { "credits": 1, "source": "own" }
}

The docs also describe a banded company_revenue_in_usd_code and company_financials[] with yearly revenue and growth. Unknown values are null, never guessed.

Revenue is thinly held. The docs call it a bonus, not a field to filter on. The tool description the model reads lists headcount, founded year and technologies but not revenue, so name the field in your prompt.

Free checks first

count_leads, list_enum_values and get_account spend no records. Run them before any paid call.

We ran count_leads with domain: ["stripe.com"] on 2026-10-01. It returned total: 10301, totalIsExact: true, credits: 0. That is mailable people at the domain, not everyone we hold.

count_leads cannot size by revenue. It does not take minRevenue or maxRevenue. To size a revenue filter, run search_companies, which spends records.

Troubleshooting

FAQ