Developers · Model Context Protocol

CompanyData MCP Server

Connect Cursor, Claude Desktop, and other MCP hosts to the CompanyData API. Search companies, enrich records, and resolve locations — without leaving your AI workflow.

Stdio MCP server — install from GitHub, run locally with your API key
Three read-only tools aligned with our public OpenAPI spec
Same auth and endpoints as the REST API you use in production

Get API key View on GitHub API quickstart

What is the MCP server?

The Model Context Protocol lets AI assistants call external tools safely. Our MCP server wraps the CompanyData HTTP API so agents can search and enrich B2B data while you code or research — using your existing API key and subscription limits.

The server runs on your machine over stdio (not hosted by CompanyData). You build once, point your MCP host at dist/index.js, and set COMPANYDATA_API_KEY in the host config.

Tools

Each tool maps directly to the REST API documented at /api-docs/. Contract details live in https://companydata.com/openapi.json.

Tool	HTTP	Description
`company_search`	`GET /api/company/search`	Search companies by name, domain, address, and other filters — same query parameters as the REST API.
`company_enrich`	`GET /api/company/export`	Export full company records by ID (export=true). Returns the field set included in your subscription.
`field_lookup`	`GET /api/cities`	Autocomplete city names for search and export filters (optional country and limit).

Install and run

Prerequisites — Node.js 18+ and a CompanyData API key (get one free).

Clone and build

git clone https://github.com/companydatacom/companydata-mcp-server.git
cd companydata-mcp-server
npm install
npm run build

Environment — set COMPANYDATA_API_KEY (required). Optional: COMPANYDATA_API_BASE_URL (default https://app.companydata.com).

Cursor configuration

In Cursor Settings → MCP, add a server entry. Replace the path with your local clone:

{
  "mcpServers": {
    "companydata": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/companydata-mcp-server/dist/index.js"],
      "env": {
        "COMPANYDATA_API_KEY": "your-api-key-here",
        "COMPANYDATA_API_BASE_URL": "https://app.companydata.com"
      }
    }
  }
}

For development without a build step, use npx tsx …/src/index.ts instead of node …/dist/index.js — see the repository README.

CompanyData MCP Server

What is the MCP server?

Tools

Install and run

Cursor configuration

Keep building