g8-mcp-server 0.20.0

graph8 MCP server - GTM operations for AI agents

g8-mcp-server

graph8 MCP server — GTM operations for AI agents.

Connects AI coding agents (Claude Code, Cursor, Windsurf) to graph8's GTM automation platform via the Model Context Protocol.

Install

# Run directly (recommended)
uvx g8-mcp-server

# Or install globally
pip install g8-mcp-server

Configure

Claude Code

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "graph8": {
      "command": "uvx",
      "args": ["g8-mcp-server"],
      "env": {
        "G8_API_KEY": "g8_key_xxxxx",
        "G8_API_URL": "https://api.graph8.com"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "graph8": {
      "command": "uvx",
      "args": ["g8-mcp-server"],
      "env": {
        "G8_API_KEY": "g8_key_xxxxx",
        "G8_API_URL": "https://api.graph8.com"
      }
    }
  }
}

Get your API key at app.graph8.com/settings/api-keys.

Tools (370+)

The server exposes 370+ tools spanning CRM, prospecting, enrichment, sequences, campaigns, studio, voice, workflows, appointments, and more. Agents don't load every schema at once — they discover tools at runtime with g8_tool_search, which ranks the catalog by query. The highlights below are a starting point.

GTM Spine (11)

Tool	Description
g8_connect_repo	Connect a GitHub/GitLab repository
g8_scan_repo	Scan repo for tech stack and GTM readiness
g8_get_scan_results	Get scan results
g8_status	Get repo connection and install status
g8_doctor	Run health checks on GTM installation
g8_install_spine	Generate GTM install patch set
g8_apply_install	Apply patches (requires confirmation)
g8_list_campaigns	List generated campaigns
g8_get_campaign	Get campaign details
g8_launch_campaign	Launch a campaign (supports dry_run)
g8_search_kb	Search the GTM knowledge base

Platform (5)

Tool	Description
g8_search_contacts	Search contacts in the CDP
g8_search_companies	Search companies by domain or industry
g8_lookup_person	Instant person enrichment
g8_lookup_company	Instant company enrichment
g8_add_to_sequence	Add contacts to a sequence (requires confirmation)

Resources (90+)

The server exposes 90+ resources — read-only context agents can include in prompts. Examples:

• g8://repos — connected repositories
• g8://repos/{id}/scan — scan results
• g8://repos/{id}/kb — knowledge base documents
• g8://repos/{id}/kb/{doc_id} — individual KB document
• g8://repos/{id}/campaigns — campaign list
• g8://repos/{id}/campaigns/{id}/brief — campaign brief
• g8://contacts — recent contacts
• g8://companies — companies

Prompts (7)

Pre-built workflow templates include:

• gtm_setup — full setup: connect → scan → install → launch
• campaign_review — review and improve a campaign
• icp_refinement — refine ICP profiles from feedback

Local stdio bridge

stdio_bridge.mjs proxies a local stdio MCP client (e.g. Claude Desktop) to the hosted graph8 MCP HTTP endpoint:

G8_API_KEY=g8_key_xxx node stdio_bridge.mjs

It targets production (https://be.graph8.com/mcp/) by default. Override the endpoint with G8_MCP_URL to point at another environment:

# QA
G8_MCP_URL=https://be.qa.graph8.com/mcp/ G8_API_KEY=g8_key_xxx node stdio_bridge.mjs
# local dev server
G8_MCP_URL=http://localhost:8000/mcp/   G8_API_KEY=g8_key_xxx node stdio_bridge.mjs

Env var	Default	Purpose
G8_MCP_URL	https://be.graph8.com/mcp/	Remote MCP HTTP endpoint the bridge proxies to
G8_API_KEY	—	Bearer token sent on every request

Development

cd mcp_server
pip install -e ".[dev]"
pytest

# stdio bridge unit tests (zero-dep, Node's built-in runner)
node --test tests/test_stdio_bridge.mjs