Skip to content

Cursor IDE Setup

Connect Cursor IDE to graph8 so you can prospect contacts, run campaigns, and query your accounts and intelligence while you code.

CursorCursor

Prerequisites

  • Cursor IDE installed (download) with MCP support (recent versions)
  • A graph8 account (get started free — 1,000 credits, no card required)

Setup (remote OAuth — recommended)

  1. Add graph8 to your MCP config

    Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for all projects):

    {
      "mcpServers": {
        "graph8": {
          "url": "https://be.graph8.com/mcp/"
        }
      }
    }

  2. Reload Cursor

    Quit and reopen Cursor, or reload the window, so it picks up the new server.

  3. Authorize (one time)

    The first time a graph8 tool is used, Cursor opens a browser tab. Sign in to graph8 and approve the connection — no API key or session ID needed. The grant binds to your account and the organization you have active when you authorize.

  4. Verify

    Open Cursor’s AI chat and ask: “What campaigns do I have in graph8?”

Self-hosted (stdio)

For headless setups, CI, or when you prefer a personal API key over OAuth, run the server locally:

{
  "mcpServers": {
    "graph8": {
      "command": "uvx",
      "args": ["g8-mcp-server"],
      "env": {
        "G8_API_KEY": "g8_...",
        "G8_MCP_MODE": "all"
      }
    }
  }
}

Create a personal API key from Profile → Developer. See MCP Overview → Modes for G8_MCP_MODE options (dev, gtm, all).

Example Questions

Once connected, try asking Cursor:

Show me my active campaigns in graph8
What accounts are in the healthcare industry?
Get the intelligence report for [account name]
Search graph8 for content about enterprise pricing

Multiple Organizations

The connection uses the organization you had active when you authorized. To switch: change organizations in graph8, then re-authorize the graph8 server in Cursor (remove and re-add, or trigger a fresh OAuth prompt).

Troubleshooting

Cursor specifics live here. Generic MCP issues (auth, permissions, JSON parse, “tool not found”) are answered in the MCP FAQ.

”MCP server not found” or no graph8 tools

  • Confirm mcp.json is valid JSON and in the correct location (.cursor/mcp.json in the project root, or ~/.cursor/mcp.json).
  • Reload Cursor after editing — the MCP client only picks up changes on reload.

Other issues

  • Session expired or authentication failed → FAQ
  • Permission denied → FAQ
  • Tool not found → FAQ
  • OAuth redirect loop → FAQ

Managing the Connection

  • Disconnect: remove the graph8 entry from mcp.json and reload Cursor. You can also revoke the OAuth grant from your graph8 Profile.
  • Re-authorize: if Cursor reports an authentication error, trigger a graph8 tool again to reopen the OAuth prompt.

Frequently Asked Questions

Does MCP work in Cursor’s chat and composer?

graph8 tools are available in Cursor’s AI chat panel. When you ask about graph8 data, Cursor invokes the appropriate MCP tools automatically.

Can multiple team members share one connection?

No. Each OAuth grant (or personal API key) is tied to an individual graph8 account and its permissions. Each teammate connects with their own account.

How do I disconnect Cursor from graph8?

Remove the graph8 entry from mcp.json and reload Cursor, and/or revoke the session from your graph8 Profile.