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

Project links

Data verified by PyPI on Aug 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.47.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for graph8 from gravatar.com graph8

Credits

Author: graph8

GitHub Statistics

Data verified by PyPI on Aug 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

ai-agents graph8 gtm mcp model-context-protocol

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

g8_mcp_server-0.36.0.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

g8_mcp_server-0.36.0-py3-none-any.whl (869.4 kB view details)

Uploaded Python 3

File details

Details for the file g8_mcp_server-0.36.0.tar.gz.

File metadata

  • Download URL: g8_mcp_server-0.36.0.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for g8_mcp_server-0.36.0.tar.gz
Algorithm Hash digest
SHA256 5198f54627633dc4553f4b569e31e0c6758caae7a509698b9416a042f2cf207f
MD5 c3eefd8031fd28a415f501101c2b9cf5
BLAKE2b-256 bbbba77d8304f653f73ee346ed677a628147f95b6e440f5e80ee47c3c0d41320

See more details on using hashes here.

Provenance

The following attestation bundles were made for g8_mcp_server-0.36.0.tar.gz:

Publisher: publish-mcp-server.yml on graph8-com/g8

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file g8_mcp_server-0.36.0-py3-none-any.whl.

File metadata

  • Download URL: g8_mcp_server-0.36.0-py3-none-any.whl
  • Upload date:
  • Size: 869.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for g8_mcp_server-0.36.0-py3-none-any.whl
Algorithm Hash digest
SHA256 876aa34ae6151bf4613355b0b307e947ee23a2290dcdccec1f445dce47901dd9
MD5 641233618af0b8c7e4b20dc8531f5fdc
BLAKE2b-256 8f9b3e1ab984fc412a1a8c87b4cd1662a87642fe25adc3e0447c2f85659f36f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for g8_mcp_server-0.36.0-py3-none-any.whl:

Publisher: publish-mcp-server.yml on graph8-com/g8

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page