GraphQL Forge

You can run MCP GraphQL Forge directly via npx without a global install, or install it globally for repeated use.

# Run directly via npx (no install required):
npx -y @toolprint/mcp-graphql-forge

# Or install globally:
npm install -g @toolprint/mcp-graphql-forge

Export the GRAPHQL_ENDPOINT environment variable pointing to your API. For authenticated APIs, set GRAPHQL_AUTH_HEADER to the full Authorization header value. For custom headers, use the GRAPHQL_HEADER_* prefix pattern.

export GRAPHQL_ENDPOINT="https://api.github.com/graphql"
export GRAPHQL_AUTH_HEADER="Bearer YOUR_GITHUB_TOKEN"

# For custom headers:
export GRAPHQL_HEADER_X_API_KEY="your-api-key"

Run the introspect command to verify the server can reach your GraphQL endpoint and parse its schema. This outputs the discovered operations that will become MCP tools.

GRAPHQL_ENDPOINT="https://api.github.com/graphql" GRAPHQL_AUTH_HEADER="Bearer YOUR_TOKEN" npx -y @toolprint/mcp-graphql-forge introspect

Register MCP GraphQL Forge in your claude_desktop_config.json with the endpoint and auth header as environment variables. Each GraphQL operation becomes a tool named query_<fieldName> or mutation_<fieldName>.

{
  "mcpServers": {
    "mcp-graphql-forge": {
      "command": "npx",
      "args": ["-y", "@toolprint/mcp-graphql-forge"],
      "env": {
        "GRAPHQL_ENDPOINT": "https://api.github.com/graphql",
        "GRAPHQL_AUTH_HEADER": "Bearer YOUR_GITHUB_TOKEN"
      }
    }
  }
}

Restart your client. The tools list should include one entry per GraphQL operation in the schema (e.g. query_viewer, query_repository, mutation_createIssue for the GitHub API). Test with a simple query tool call.