graphe-mcp 0.1.1

MCP server for connecting AI tools to the Graphe API

graphe-mcp

Model Context Protocol (stdio) server for Graphe. Connect Cursor, Claude Desktop, and other MCP hosts to your Graphe workspace.

Install

pip install graphe-mcp

Configuration

Set environment variables (or pass them in your MCP host config):

Variable	Purpose
GRAPHE_API_BASE	API URL
GRAPHE_API_KEY	API key from the Graphe console
GRAPHE_WORKSPACE_ID	Workspace scope
GRAPHE_PROJECT_ID	Project scope

Example .cursor/mcp.json:

{
  "mcpServers": {
    "graphe": {
      "command": "graphe-mcp",
      "env": {
        "GRAPHE_API_BASE": "https://api.yourdomain.com",
        "GRAPHE_API_KEY": "graphe_live_...",
        "GRAPHE_WORKSPACE_ID": "...",
        "GRAPHE_PROJECT_ID": "..."
      }
    }
  }
}

Run

graphe-mcp

In your MCP host, call graphe_health to verify connectivity.

Tools

Read tools include current state, hybrid search, runs, claims, and entities. Write tools are limited to safe ingestion (graphe_create_run, graphe_log_event, graphe_create_annotation) with required idempotency keys. Claim lifecycle mutations are CLI-only.

Full tool list: MCP documentation.