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_company_open_jobs What CRM companies are hiring for now (growth signal, not the marketplace)
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_live_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_test_xxx node stdio_bridge.mjs
# local dev server
G8_MCP_URL=http://localhost:8000/mcp/   G8_API_KEY=g8_test_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

The bridge preserves the Streamable HTTP Mcp-Session-Id returned during initialization, so subsequent notifications and tool calls stay attached to the same remote session.

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 27, 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.49.5)

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 27, 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.49.4.tar.gz (1.6 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.49.4-py3-none-any.whl (918.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: g8_mcp_server-0.49.4.tar.gz
  • Upload date:
  • Size: 1.6 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.49.4.tar.gz
Algorithm Hash digest
SHA256 f8ab6e5fdf6f5360646bbc8fa0907241336547633a55152dd130410992da9ebf
MD5 0b1a15d1d3fdd1cb95d4330d0f7d04df
BLAKE2b-256 683591b7814ad8f0245498c9de4d1885467a447e6588346408307e5edf316f55

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: g8_mcp_server-0.49.4-py3-none-any.whl
  • Upload date:
  • Size: 918.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.49.4-py3-none-any.whl
Algorithm Hash digest
SHA256 c1fda01f33933b702d93f64f26f489233ee802960f3a7bc1133f7d164c353cfb
MD5 9aad0abed9fb6886c831537a3f8496a4
BLAKE2b-256 2473f9505633ff96c4c481377f398c2d6268b295d64973f8207612333aa83c3c

See more details on using hashes here.

Provenance

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

Release history Release notifications | RSS feed

0.49.5

2 files

This release

0.49.4 This release

2 files

0.49.3

2 files

0.49.2

2 files

0.49.0

2 files

0.47.0

2 files

0.46.0

2 files

0.45.1

2 files

0.37.1

2 files

0.37.0

2 files

0.36.0

2 files

0.34.0

2 files

0.33.0

2 files

0.32.0

2 files

0.30.0

2 files

0.28.1

2 files

0.28.0

2 files

0.27.1

2 files

0.27.0

2 files

0.26.0

2 files

0.24.0

2 files

0.22.2

2 files

0.22.1

2 files

0.22.0

2 files

0.21.3

2 files

0.21.2

2 files

0.21.1

2 files

0.21.0

2 files

0.20.0

2 files

0.19.0

2 files

0.18.0

2 files

0.17.1

2 files

0.17.0

2 files

0.16.0

2 files

0.15.0

2 files

0.14.0

2 files

0.10.5

2 files

0.10.4

2 files

0.10.3

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.15

2 files

0.9.14

2 files

0.9.13

2 files

0.9.12

2 files

0.9.10

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.2

2 files

0.9.0

2 files

0.8.1

2 files

0.8.0

2 files

0.6.12

2 files

0.6.11

2 files

0.6.10

2 files

0.6.9

2 files

0.6.8

2 files

0.6.6

2 files

0.6.5

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page