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 24, 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:
Latest release

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 24, 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.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.49.0-py3-none-any.whl (914.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: g8_mcp_server-0.49.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.49.0.tar.gz
Algorithm Hash digest
SHA256 6755a0f4ce04131150808e55445578b7c2e8780becff1ecec27fec86e0735054
MD5 e349a8d8e21d0c9323675d6d68c951dd
BLAKE2b-256 c659aa1e3ed537ae045d0e266ac2de16e44037b0936f0a1b910a9da46176abe6

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: g8_mcp_server-0.49.0-py3-none-any.whl
  • Upload date:
  • Size: 914.0 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 515043fe9737d56ce416281820a8f0f7e0b164728f51aceebd1138c27e7eb62e
MD5 92d11abbbb2fe856df8f24815cec6821
BLAKE2b-256 5a90f9c5eccebce460634a246c09995a1821b263f181ac91f7070a776ee75285

See more details on using hashes here.

Provenance

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

This release

0.49.0 This release

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

Supported by

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