DocumentationAgents and APIDeveloper APIData coverage by countrySDKMCP

Global Data Capital · MCP

Connect Global Data Capital to your AI

Search and verify companies across the Americas from ChatGPT, Claude, Cursor and your coding agents, using the Model Context Protocol.

Server URL

https://globaldatacapital.com/api/mcp

Read-only · 3 toolsStreamable HTTPFree to start

View as Markdown

One command for every coding agent

npx add-mcp https://globaldatacapital.com/api/mcp --name gdc --header "Authorization: Bearer ${GDC_API_KEY}"

Example prompts

  • Find CORPORACIÓN FAVORITA C.A. in Ecuador and show its RUC.

  • Get company details for EC 1790016919001.

  • Search for cement companies in Colombia.

Tools (reads only)

Read-only

These three tools call the existing /api/v1 search, entity, and financials handlers. There are no write tools, no contacts tool, and no geo/search_area.

ToolArgumentsMaps to
search_companiesq, country?, limit?GET /api/v1/search
get_companycountry, identifierGET /api/v1/entities/…
get_financialscountry, identifierGET /api/v1/entities/…/financials

get_financials uses the same plan gate as the REST route: 403 if the plan cannot see numbers. Demo lock: Corporación Favorita EC 1790016919001.

Authentication

Global Data Capital MCP uses your API key: Authorization: Bearer gdc_live_…. Keys are the same as the Developer API (/api/v1). We never put a live key in a public link.

Create a free API key in Developer settings. Free includes 33 searches; upgrade to Pro for financials, Pro+ for contacts, Enterprise for everything else.

Plans and pricingDeveloper settings

Troubleshooting

401

Key missing or wrong. Send Authorization: Bearer gdc_live_…

403 on get_financials

Plan gate: Free cannot see financials. Upgrade to Pro on /pricing.

Cursor link does not open on Linux

Use the web link (cursor.com/en/install-mcp) with the env-var config. Signed-in installs use cursor:// so the live key never goes to cursor.com.

VS Code asks for a key

That is the input prompt (password: true). Paste your gdc_live_ key.

/mcp is not this server

/en/mcp stays the in-product agent route (unauthenticated visitors get a login redirect). This install page is /en/docs/mcp. The MCP HTTP endpoint is only /api/mcp.

Developer API docs · SDK · Agent docs · Create an API key

Coming soon: needs sign-in with Global Data Capital

ChatGPT connects to MCP servers through sign-in (OAuth). Global Data Capital sign-in for ChatGPT is coming soon. Today, use Codex with your API key, or connect from Claude, Cursor or VS Code.

  1. ChatGPT custom MCP needs OAuth — that is not available yet.
  2. Use Codex, Claude, Cursor or VS Code with a gdc_live_ key.
https://globaldatacapital.com/api/mcp

https://chatgpt.com/plugins

Ready

Add to Claude

Log in to attach a keySign up to attach a key

  1. Claude opens the Add custom connector dialog with our name and URL filled in.
  2. Under Authentication choose No sign in.
  3. Under Request headers add Authorization: Bearer <your gdc_live_ key>.
  4. Add.
Authorization: Bearer gdc_live_…
https://globaldatacapital.com/api/mcp

Ready

Add to Cursor

Log in to attach a keySign up to attach a key

  1. Click Add to Cursor. Logged out, the HTTPS hop uses GDC_API_KEY; signed in, cursor:// attaches your minted key (never in a cursor.com URL).
  2. Confirm in the Cursor app.
  3. Linux: if cursor:// does not open, use the web link.
{
  "url": "https://globaldatacapital.com/api/mcp",
  "headers": {
    "Authorization": "Bearer ${env:GDC_API_KEY}"
  }
}

cursor.com/en/install-mcp · cursor://

Ready

Install in VS Code

Log in to attach a keySign up to attach a key

  1. Click Install in VS Code (vscode:mcp/install handler).
  2. When VS Code asks for a key, paste gdc_live_… (password prompt).
{
  "inputs": [
    {
      "type": "promptString",
      "id": "gdc-api-key",
      "description": "Global Data Capital API key",
      "password": true
    }
  ],
  "servers": {
    "gdc": {
      "type": "http",
      "url": "https://globaldatacapital.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gdc-api-key}"
      }
    }
  }
}

Ready

Log in to attach a keySign up to attach a key

  1. Copy the command.
  2. Paste it in a terminal with GDC_API_KEY exported.
claude mcp add --transport http gdc https://globaldatacapital.com/api/mcp --header "Authorization: Bearer ${GDC_API_KEY}"
claude mcp add-json gdc '{"type":"http","url":"https://globaldatacapital.com/api/mcp","headers":{"Authorization":"Bearer ${GDC_API_KEY}"}}'

Ready

Log in to attach a keySign up to attach a key

  1. Copy the official command.
  2. Codex writes ~/.codex/config.toml with bearer_token_env_var.
codex mcp add gdc --url https://globaldatacapital.com/api/mcp --bearer-token-env-var GDC_API_KEY

[mcp_servers.gdc]
url = "https://globaldatacapital.com/api/mcp"
bearer_token_env_var = "GDC_API_KEY"

Ready

Log in to attach a keySign up to attach a key

  1. Copy the gemini mcp add command.
  2. Confirm in ~/.gemini/settings.json.
gemini mcp add --transport http --header "Authorization: Bearer ${GDC_API_KEY}" gdc https://globaldatacapital.com/api/mcp

Ready

Log in to attach a keySign up to attach a key

  1. Copy the JSON (serverUrl field).
  2. Paste it into ~/.codeium/windsurf/mcp_config.json.
{
  "mcpServers": {
    "gdc": {
      "serverUrl": "https://globaldatacapital.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GDC_API_KEY}"
      }
    }
  }
}

Ready

Log in to attach a keySign up to attach a key

  1. Settings → MCP Marketplace → Add custom MCP (org admin).
  2. HTTP URL plus header Authorization: Bearer gdc_live_…
https://globaldatacapital.com/api/mcp

Ready

Log in to attach a keySign up to attach a key

  1. Copy the context_servers JSON.
  2. Paste a literal key — Zed does not interpolate env.
{
  "context_servers": {
    "gdc": {
      "url": "https://globaldatacapital.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <gdc_live_…>"
      }
    }
  }
}

Ready

Add to LM Studio

Log in to attach a keySign up to attach a key

  1. Open the lmstudio:// deeplink (placeholder YOUR_GDC_API_KEY).
  2. Edit the key in LM Studio.
lmstudio://add_mcp?name=gdc&config=eyJ1cmwiOiJodHRwczovL2dsb2JhbGRhdGFjYXBpdGFsLmNvbS9hcGkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfR0RDX0FQSV9LRVkifX0=

Ready

Open Cloud Agents

Log in to attach a keySign up to attach a key

  1. Cursor Cloud Agents: cursor.com/agents → + → MCP Servers → Add.
  2. Or npx add-mcp for most coding agents.
https://globaldatacapital.com/api/mcp

cursor.com/agents

Create a free API key in Developer settings. Free includes 33 searches; upgrade to Pro for financials, Pro+ for contacts, Enterprise for everything else.