Llmgraph MCP server

@llmgraph/mcp-server

A Model Context Protocol (MCP) server that exposes your LLMGraph workflow deployments as MCP tools. Connect it to Claude Desktop, Claude Code, Cursor, or any other MCP client, and your assistant can invoke the workflows you built and deployed on LLMGraph.

Each configured deployment becomes one MCP tool. The server runs over stdio and is designed to be launched with npx, so there is nothing to install permanently.

Prerequisites

• Node.js 18 or newer
• A deployed LLMGraph workflow: copy the deployment endpoint URL (shaped like https://llmgraph.ai/api//) and an API key from the LLMGraph dashboard

Configuration

All configuration is via environment variables.

Single deployment (simple path)

Multiple deployments (advanced path)

Set LLMGRAPH_DEPLOYMENTS to a JSON array; each entry becomes one tool. When set, it takes precedence over the single-deployment variables.

[
  {
    "name": "summarize_document",
    "description": "Summarizes a document with the LLMGraph summarizer workflow",
    "endpoint": "https://llmgraph.ai/api/abc123/production",
    "apiKey": "your-api-key"
  },
  {
    "name": "support_bot",
    "description": "Asks the support assistant workflow a question",
    "endpoint": "https://llmgraph.ai/api/def456/production",
    "apiKey": "your-other-api-key",
    "inputSchema": "chat"
  }
]

Schema modes

• input (default): the tool takes { "input": } and the object is passed through unchanged as the POST body, so it works with any workflow input shape.
• chat: for chat-style workflows. The tool takes { "user_input": , "history": [{"role": "user"|"assistant", "content": }] } (history optional) and sends it in the shape chat workflows expect.

Client setup

Claude Desktop

Add to claudedesktopconfig.json (Settings, Developer, Edit Config):

{
  "mcpServers": {
    "llmgraph": {
      "command": "npx",
      "args": ["-y", "@llmgraph/mcp-server"],
      "env": {
        "LLMGRAPH_ENDPOINT": "https://llmgraph.ai/api/abc123/production",
        "LLMGRAPH_API_KEY": "your-api-key",
        "LLMGRAPH_TOOL_NAME": "summarize_document",
        "LLMGRAPH_TOOL_DESCRIPTION": "Summarizes a document with my LLMGraph workflow"
      }
    }
  }
}

Restart Claude Desktop and the tool appears in the tools menu.

Claude Code

claude mcp add llmgraph \
  --env LLMGRAPH_ENDPOINT=https://llmgraph.ai/api/abc123/production \
  --env LLMGRAPH_API_KEY=your-api-key \
  -- npx -y @llmgraph/mcp-server

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

{
  "mcpServers": {
    "llmgraph": {
      "command": "npx",
      "args": ["-y", "@llmgraph/mcp-server"],
      "env": {
        "LLMGRAPH_ENDPOINT": "https://llmgraph.ai/api/abc123/production",
        "LLMGRAPH_API_KEY": "your-api-key"
      }
    }
  }
}

Error handling

Non-200 responses from the LLMGraph API are returned to the client as MCP tool errors carrying the API's error message:

Shortened. The full README is on GitHub.