mcpField
C
CompanyData

CompanyData

VerifiedFeaturedRemote
companydata.comData & Analytics2Updated 3w ago
DocsRepositoryVisit website

About CompanyData

CompanyData is an MCP server for AI agents and other MCP clients that need company records and location data. It provides search, company enrichment, and city lookup through hosted or locally run options.

Key features

  1. 01Search companies
  2. 02Enrich company records
  3. 03Look up cities
  4. 04Hosted or local deployment

Use cases

  1. 01Find companies matching a query
  2. 02Retrieve firmographic details by company ID
  3. 03Resolve or suggest city names

MCP support

Exposes the CompanyData HTTP API through three MCP tools: `company_search`, `company_enrich`, and `field_lookup`. Clients can connect to its hosted Streamable HTTP endpoint or run the npm package locally.

#company-data#b2b#enrichment#kyb#firmographics#business-registry#api

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://companydata.com/mcp/
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

All endpoints
Streamable HTTPhttps://companydata.com/mcp/Auth required
Packages
npm@companydata/mcp-server1.1.0

Tools

Details

From the project README

CompanyData MCP server

Model Context Protocol server that exposes the CompanyData HTTP API as tools: company search, company export (enrich), and location lookup (cities).

Product overview and setup guide: companydata.com/product/mcp-server/.

OpenAPI contract: https://companydata.com/openapi.json.

Hosted (no install)

Connect your MCP client to https://companydata.com/mcp/ and send your API key in the x-api-key header (get a key).

Claude Code:

claude mcp add --transport http companydata https://companydata.com/mcp/ --header "x-api-key: your-api-key-here"

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "companydata": {
      "url": "https://companydata.com/mcp/",
      "headers": { "x-api-key": "your-api-key-here" }
    }
  }
}

Local (npx)

Requires Node.js 18+.

{
  "mcpServers": {
    "companydata": {
      "command": "npx",
      "args": ["-y", "@companydata/mcp-server"],
      "env": { "COMPANYDATA_API_KEY": "your-api-key-here" }
    }
  }
}

Build from source

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

Environment

VariableRequiredDescription
COMPANYDATA_API_KEYYesSent as x-api-key on every request
COMPANYDATA_API_BASE_URLNoAPI origin, default https://app.companydata.com (no trailing slash)

Copy .env.example to .env for local testing with npm run dev (load env in shell: set -a && source .env && set +a && npm run dev).

Tools

ToolAPI
company_searchGET /api/company/search
company_enrichGET /api/company/export with ID and export=true
field_lookupGET /api/cities

Cursor & Claude Desktop

  1. Build the project (npm run build).
  2. In your MCP host (e.g. Cursor Settings → MCP or Claude Desktop config), add a server (adjust paths):
{
  "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"
      }
    }
  }
}
  1. Reload MCP / restart Cursor if needed.

Smoke checklist

  • Server starts without errors (npm run build && node dist/index.js with env set).
  • MCP host lists tools: company_search, company_enrich, field_lookup.
  • company_search returns 200 payload for a simple query (e.g. search=BoldData).
  • field_lookup returns city suggestions (e.g. search=amst).

Development without a separate build step:

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

CLI

After npm run build, the package exposes companydata-mcp when linked (npm link) or when node_modules/.bin is on PATH.

Distribution

  • Hosted: https://companydata.com/mcp/ (Streamable HTTP, stateless). The website serves the same tools from a copy of src/tools.ts.
  • npm: @companydata/mcp-server.
  • Official MCP Registry: com.companydata/mcp (see server.json).

License

ISC

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.