← Back to knowledge base

API

5 min read

The MCP Server

Connect AI clients like Claude Desktop and Cursor to Fullpilot as tools over MCP.

What it is

The Fullpilot MCP server exposes the API as Model Context Protocol tools, so AI clients such as Claude Desktop, Cursor, Windsurf, and n8n can search local businesses, reveal contacts, and enrich companies directly.

It is a thin wrapper over the same REST API, so it uses the same API keys and the same credit rules.

Connect over hosted HTTP

The hosted server lives at https://mcp.fullpilot.com/mcp and uses streamable HTTP. Point your client at that URL and pass your key as an Authorization header.

A typical client config looks like: mcpServers, then fullpilot, with url set to https://mcp.fullpilot.com/mcp and headers set to Authorization: Bearer fp_live_your_key.

Connect locally over stdio

For desktop clients that launch a local process, run the server with npx. Set command to npx, args to -y and @fullpilot/mcp, and provide your key in the environment as FULLPILOT_API_KEY set to fp_live_your_key.

Both transports talk to the same API, so pick whichever your client supports.

Available tools

search_parse: turn a natural-language description into a structured search query.

search: run a structured search and get matching companies, with contact data left locked.

unlock_contact: spend one credit to reveal a business's email or phone. Records already unlocked by your workspace are free.

unlock_batch: unlock many businesses at once from a results id or a list of ids.

enrich_company: resolve a company you already know by domain, name, or location and return its available contacts.