English Français العربية

CompanyData

السجل الرسمي الحكومة والقانون

Company search and enrichment from official business registers in 200+ countries.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http companydata 'https://companydata.com/mcp/' --header 'x-api-key: <Your CompanyData API key (https://app.companydata.com/signup-api)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "companydata": {
            "type": "http",
            "url": "https://companydata.com/mcp/",
            "headers": {
                "x-api-key": "<Your CompanyData API key (https://app.companydata.com/signup-api)>"
            }
        }
    }
}
NPM package @companydata/mcp-server
Claude Code 
claude mcp add companydata -e 'COMPANYDATA_API_KEY=<your companydata_api_key>' -- npx -y @companydata/mcp-server@1.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "companydata": {
            "command": "npx",
            "args": [
                "-y",
                "@companydata/mcp-server@1.1.0"
            ],
            "env": {
                "COMPANYDATA_API_KEY": "<your companydata_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • COMPANYDATA_API_KEY إلزامي سري Your CompanyData API key (https://app.companydata.com/signup-api)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. CompanyData MCP server
  2. Hosted (no install)
  3. Local (npx)
  4. Build from source
  5. Environment
  6. Tools
  7. Cursor & Claude Desktop
  8. Smoke checklist
  9. CLI
  10. Distribution
  11. License

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

الأسئلة الشائعة

ما هو CompanyData؟

Company search and enrichment from official business registers in 200+ countries.

كيف أثبّت CompanyData؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http companydata 'https://companydata.com/mcp/' --header 'x-api-key: <Your CompanyData API key (https://app.companydata.com/signup-api)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج CompanyData إلى مفتاح API؟

نعم. يتطلب COMPANYDATA_API_KEY, x-api-key، وتضبطها في إعداداته.

هل CompanyData مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون CompanyData؟

ينشره companydatacom. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.