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 7, 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 7, 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.37.1.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.37.1-py3-none-any.whl (870.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: g8_mcp_server-0.37.1.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.37.1.tar.gz
Algorithm Hash digest
SHA256 8b0455c014f648cecee650b37a2042b3725f2bc8f960e3f53b662c7045aca3f2
MD5 a6131b1660e6dbdc9e837d889852002a
BLAKE2b-256 118745ca1cf6f5985db2527ed515484e7b0f5c012076af12881036986813bd01

See more details on using hashes here.

Provenance

The following attestation bundles were made for g8_mcp_server-0.37.1.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.37.1-py3-none-any.whl.

File metadata

  • Download URL: g8_mcp_server-0.37.1-py3-none-any.whl
  • Upload date:
  • Size: 870.9 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.37.1-py3-none-any.whl
Algorithm Hash digest
SHA256 62f1ab9303fcdbc5b63338838a6ad54169de38aa4b9901566846beed5e36832f
MD5 85657faa62c4b9377eac0d87e2433b8e
BLAKE2b-256 8e4f002114ae3de22e1568bd676de6e0bda96ba011e82b04368e830fa7a2cf3c

See more details on using hashes here.

Provenance

The following attestation bundles were made for g8_mcp_server-0.37.1-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