Skip to main content
Resources
Agent Grounding Handbooks

AI Agent Grounding: Connecting to the GraphIQ.ai MCP Server.

The Model Context Protocol (MCP) is an open standard that lets AI assistants and automated agents call our platform data tools natively. This guide outlines how to plug our HTTP streamable server (app.graphiq.ai/mcp) directly into active LLM reasoning loops. Grounding your models in a pre-resolved graph of 287M organizations gives them verified entities to reason over instead of scraped text. Agents get four tools on connection: search_organizations, search_employment_route, search_news, and list_industries.

Configuration

Three client configuration architectures.

PATH 01

Interactive local environments

Claude Desktop & Claude Code. Configure a standardized server block in your client config file (.mcp.json), passing keys through an explicit X-API-Key server header wrapper.

Claude DesktopClaude Code
.mcp.json
{ "mcpServers": {
    "graphiq": {
      "url": "https://app.graphiq.ai/mcp",
      "headers": {
        "X-API-Key": "$GRAPHIQ_KEY"
      }
    }
} }
PATH 02

Programmatic cloud environments

For Anthropic Messages pipelines, register our HTTP endpoint inside the beta tools array with the required protocol headers. For OpenAI Responses, configure our secure root URL as an authorized remote tool extension.

Claude APIOpenAI Responses
messages.py
client.beta.messages.create(
  model="claude-opus-4",
  mcp_servers=[{
    "type": "url",
    "url": "https://app.graphiq.ai/mcp",
    "authorization_token": GRAPHIQ_KEY
  }],
)
PATH 03

Custom orchestration pipelines

LangChain & LangGraph adapters. Expose our discoverable tool logic blocks across custom multi-agent frameworks by deploying standard Python multi-server MCP adapter setups.

LangChainLangGraph
agent.py
from langchain_mcp import MultiServerMCPClient

client = MultiServerMCPClient({
  "graphiq": {
    "url": "https://app.graphiq.ai/mcp",
    "transport": "streamable_http"
  }
})
tools = await client.get_tools()
Security

Account identifier & data security.

How are authentication rights split? Access routes through one of two mechanisms depending on the calling environment.

X-API-Key

CLI environments, background scripts, server-to-server networks, and remote LLM provider connectors verify access tokens using an API key header.

OAuth 2.0

Interactive web clients — including claude.ai web views and Claude Desktop app setups — route connections securely via standard browser OAuth 2.0 sign-in loops.

Connect the dots

Where MCP agent access connects your GTM.

Talk to our team

Connect your AI agents to a verifiable source of truth.

Talk to our team to initialize your MCP server connection, run a test query against 287M resolved organizations, and verify your agent toolchain configuration end-to-end.

Chat with us