Current Role with MCP

Give Claude or Cursor a LinkedIn URL, email or person_id and the agent calls get_lead to return the job title and company that person holds now. 1 record per hit, a miss is free.

This page is about setup and prompts. For the field list and what "current" means in the data, see Current Role. For the REST call, see Current Role API. 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 OAuth sign-in the first time the server is used. Other clients use the same URL, see the LeadOcean MCP docs.

The tool

Current role has no tool of its own. It comes back inside get_lead, which the server lists as leadocean_get_lead. It costs 1 record per found person. The REST twin is POST /v1/people/enrich.

Send exactly one identifier. There is no name plus company lookup. To check a whole team, search_leads returns the current title and company on every row, at 1 record per person.

Prompts that work

Put the record limit in the prompt. "Stop after 25 records" is enough for the agent to hold a batch.

What the agent gets back

The result is one leadocean.person.v1 object plus a meta block. The current role sits in contact_data.contact_current_experiences. Below is the enrich docs sample, September 2026, trimmed to the role fields.

{
  "success": true,
  "data": {
    "profile_data": {
      "profile_full_name": "Sarah Chen",
      "profile_headline": "Founder & CEO at CloudSync"
    },
    "contact_data": {
      "contact_current_experiences": [{
        "company_name": "CloudSync",
        "company_domain": "cloudsync.com",
        "job_title": "Founder & CEO",
        "company_employees": { "number_of_employees": 120 }
      }]
    }
  },
  "meta": { "credits": 1, "source": "own" }
}

The docs also list job_title_details, job_seniority and job_functions[] on experience objects. A field we do not hold is null, never guessed. Over MCP, resume_data is empty today, so the agent cannot return past employers.

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 title: ["Head of Growth"] and country: ["US"] on 2026-10-01. It returned total: 1646, totalIsExact: true, credits: 0. That counts mailable people (verified, catch_all_valid or catch_all), not everyone we hold.

Troubleshooting

FAQ