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 Record the tech stack and GTM readiness you read from the code
g8_get_scan_results Get scan results
g8_status Get repo connection and install status
g8_doctor Report the graph8-side state of a repo's GTM install
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 Sep 1, 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.57.1)

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 Sep 1, 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.51.0.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.51.0-py3-none-any.whl (926.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: g8_mcp_server-0.51.0.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.51.0.tar.gz
Algorithm Hash digest
SHA256 5bea324eb5a0f7d64a3f5403b60ef494d352e3d47357a1724d058aa67100f3e5
MD5 c19aca1ca0108b34d4bf6ce3b94bbb9e
BLAKE2b-256 5a3f9af6eeb3668844de5c910fd20efa6de8b1909db3288fda99bcde75d43cde

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: g8_mcp_server-0.51.0-py3-none-any.whl
  • Upload date:
  • Size: 926.8 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.51.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0097693ed5febfd5129bb5550e9f7931a86084d385d88c0aa2e3739e0b68c1d3
MD5 3ee118ae7ed5817117df791b32cfc182
BLAKE2b-256 81c835bfccebb0243940523e98f780d3de33cf15f30e2355755bf2e10e7e0ba5

See more details on using hashes here.

Provenance

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

Release history Release notifications | RSS feed

0.57.1

2 files

0.57.0

2 files

0.56.0

2 files

0.55.0

2 files

0.53.0

2 files

0.51.1

2 files

This release

0.51.0 This release

2 files

0.50.0

2 files

0.49.5

2 files

0.49.4

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