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, and Cursor.

​
Server URL

https://api.datalegion.ai/mcp

​
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

Add to your editor’s MCP settings with the same URL and API key header.

​
Available Tools

The MCP server exposes 9 tools that map directly to the Data Legion REST API endpoints. Credits are consumed the same way as direct API calls.

​
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
person_discoverFind people using natural languagePOST /person/discover

​
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
company_discoverFind companies using natural languagePOST /company/discover

​
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.