Start Building with Purple8 in 10 Seconds

Option A - Try it directly in your browser

The MCP Console is built into every Purple8 container. Open it, pick any of the 170+ tools, fill in the arguments, and run - no client installation, no code.

Or call any tool directly over HTTP with curl:

curl -X POST http://localhost:8100/mcp \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 1,
    "params": {
      "name": "graph.counts",
      "arguments": {}
    }
  }'

A successful response returns a JSON object with a result field containing node and edge counts. If you see that, the MCP server is live.

Option B - Claude Code (CLI)

One command registers Purple8 as an MCP server in your Claude Code session. After this, Claude can call all 170+ tools from any conversation.

claude mcp add purple8 --transport http "http://localhost:8100/mcp?profile=starter" \
  --header "X-API-Key: YOUR_API_KEY"

Verify it worked: ask Claude “Call graph.counts and tell me how many nodes are in the database.”

Option C - Claude Desktop

Connect Claude Desktop to your running container or Cloud Sandbox using mcp-remote in claude_desktop_config.json, or use Settings → Connectors → Add custom connector with your https://<host>/mcp?profile=starter URL.

{
  "mcpServers": {
    "purple8-graph": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8100/mcp?profile=starter",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

Option D - Cursor

Add to your Cursor MCP config file (~/.cursor/mcp.json) or via Cursor Settings → MCP → Add Server:

{
  "mcpServers": {
    "purple8-graph": {
      "url": "http://localhost:8100/mcp?profile=starter",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Option E - VS Code / GitHub Copilot

Add to your VS Code .vscode/mcp.json (workspace) or settings.json (user-level):

{
  "servers": {
    "purple8-graph": {
      "type": "http",
      "url": "http://localhost:8100/mcp?profile=starter",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

After adding, open the Copilot Chat panel, switch to Agent mode, and Purple8 tools will appear in the tool list.

Option F - OpenAI Codex

Codex reads MCP servers from ~/.codex/config.toml. Add the Purple8 bridge there:

[mcp_servers.purple8]
url = "http://localhost:8100/mcp?profile=starter"
http_headers = { "X-API-Key" = "YOUR_API_KEY" }

Restart Codex after saving. Purple8’s 170+ tools will be available in every Codex session automatically.