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 inside a pre-resolved graph of 300M+ organizations prunes hallucination loops by up to 87%.

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.

Grounding assistant

Connect your AI agents to a verifiable source of truth.

Talk to the grounding assistant to initialize your MCP server connection, run a test query against 300M+ resolved organizations, and verify your agent toolchain configuration end-to-end.

Talk to the grounding assistant →