Skip to main content
The Data Legion MCP server lets AI assistants access your person and company data through tool calls. It works with any MCP-compatible client including Claude Code, Claude Desktop, ChatGPT, Gemini, Cursor, OpenClaw, Cline, Continue, Windsurf, and Goose.

​
Server URL

https://api.datalegion.ai/mcp

​
Discovery

We publish discovery metadata so MCP-compatible agents can detect the server, its tools, and its auth method automatically:

​
Authentication

The MCP server uses the same API-Key authentication as the REST API. Pass your API key in the headers section of your MCP client configuration. The key is forwarded to the API on every tool call, so credits and rate limits apply exactly as they do for direct API calls.

​
Setup

​
Claude Code

Add to your project’s .mcp.json: 
{
  "mcpServers": {
    "datalegion": {
      "type": "http",
      "url": "https://api.datalegion.ai/mcp",
      "headers": {
        "API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Or via CLI: 
claude mcp add --transport http datalegion https://api.datalegion.ai/mcp \
  --header "API-Key: YOUR_API_KEY"

​
Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS): 
{
  "mcpServers": {
    "datalegion": {
      "type": "http",
      "url": "https://api.datalegion.ai/mcp",
      "headers": {
        "API-Key": "YOUR_API_KEY"
      }
    }
  }
}

​
Cursor

Open Cursor Settings → MCP, add a new server with name datalegion, transport HTTP, URL https://api.datalegion.ai/mcp, and add an API-Key header with your key. Or paste this into your project’s .cursor/mcp.json: 
{
  "mcpServers": {
    "datalegion": {
      "type": "http",
      "url": "https://api.datalegion.ai/mcp",
      "headers": {
        "API-Key": "YOUR_API_KEY"
      }
    }
  }
}

​
ChatGPT

In a Custom GPT or workspace with MCP enabled, add a connector pointing at https://api.datalegion.ai/mcp. Set authentication to Custom header with header name API-Key and your key as the value. ChatGPT will discover the seven Data Legion tools and call them automatically.

​
Gemini (Gemini CLI / Code Assist)

In your ~/.gemini/settings.json (or workspace settings): 
{
  "mcpServers": {
    "datalegion": {
      "httpUrl": "https://api.datalegion.ai/mcp",
      "headers": {
        "API-Key": "YOUR_API_KEY"
      }
    }
  }
}

​
OpenClaw

OpenClaw discovers MCP servers via the standard MCP config block. Add this to your OpenClaw mcp.json: 
{
  "mcpServers": {
    "datalegion": {
      "type": "http",
      "url": "https://api.datalegion.ai/mcp",
      "headers": {
        "API-Key": "YOUR_API_KEY"
      }
    }
  }
}
OpenClaw’s tool dispatcher will then expose all seven Data Legion tools to the agent loop.

​
Other MCP-compatible clients

Cline, Continue, Windsurf, Goose, and any other client that speaks Model Context Protocol over Streamable HTTP work the same way: point them at https://api.datalegion.ai/mcp and pass your key in the API-Key header. The server-card at /.well-known/mcp/server-card.json advertises capabilities and tools so compatible clients can connect with no further configuration.

​
Available Tools

The MCP server exposes 7 tools that map directly to the Data Legion REST API endpoints. Credits are consumed the same way as direct API calls. The natural-language /person/discover and /company/discover REST endpoints are not exposed via MCP today; call them from the REST API or SDKs.

​
Person

ToolDescriptionAPI Equivalent
person_enrichLook up a person by email, phone, name, LinkedIn, or other identifiersPOST /person/enrich
person_searchQuery people using SQL WHERE syntaxPOST /person/search

​
Company

ToolDescriptionAPI Equivalent
company_enrichLook up a company by domain, name, ticker, or LinkedInPOST /company/enrich
company_searchQuery companies using SQL WHERE syntaxPOST /company/search

​
Utilities

ToolDescriptionAPI Equivalent
utility_cleanNormalize emails, phones, names, domains, and other fieldsPOST /utility/clean
utility_hash_emailHash an email address (SHA-256, SHA-1, MD5) for privacy-safe lookupsPOST /utility/hash/email
utility_validateValidate data format and get cleaning suggestionsPOST /utility/validate

​
Example Conversations

Once connected, you can ask your AI assistant things like:
  • “Look up the person with email jane.doe@acme.com”
  • “Find software engineers in San Francisco who worked at Google”
  • “Enrich the company google.com”
  • “Search for AI startups with more than 50 employees”
  • “Clean and validate this contact: email john.doe+work@gmail.com, phone (555) 123-4567”
  • “Hash the email john@example.com for a privacy-safe lookup”
The AI assistant will automatically select the right tool based on your request.

​
Credits

MCP tool calls consume credits at the same rate as the corresponding REST API endpoints.

​
Rate Limits

The same rate limits apply to MCP tool calls as to direct API calls.