Query any live GraphQL endpoint — introspect schema and run queries/mutations via mcp-graphql (npm, stdio)

{
  "server": "mcp-graphql",
  "version": "2.0.4",
  "transport": "stdio",
  "install": "npm install mcp-graphql",
  "entry": "node -e '...' with ENDPOINT and ENTRY env vars",
  "tools_count": 2,
  "resources_count": 1,
  "calls": 9,
  "success_rate": "89% (8/9 — 1 bug in variables handling)",
  "p50_ms": 150,
  "first_call_ms": 350,
  "bug_found": "variables double-serialization at dist/index.js:22695-22704",
  "tested_endpoint": "https://countries.trevorblades.com/graphql",
  "handshake": {
    "initialize": {
      "request": {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "initialize",
        "params": {
          "protocolVersion": "2024-11-05",
          "capabilities": {},
          "clientInfo": {
            "name": "pathfinder",
            "version": "1.0"
          }
        }
      },
      "response": {
        "jsonrpc": "2.0",
        "id": 1,
        "result": {
          "protocolVersion": "2024-11-05",
          "capabilities": {
            "tools": {
              "listChanged": false
            },
            "resources": {}
          },
          "serverInfo": {
            "name": "mcp-graphql",
            "version": "2.0.4"
          }
        }
      }
    },
    "tools_list": {
      "tool_count": 2,
      "tools": ["introspect-schema", "query-graphql"]
    }
  },
  "tested_tools": [
    {
      "tool": "introspect-schema",
      "result_excerpt": "Full SDL: type Country { code: ID!, name: String!, ... } type Continent { ... } type Language { ... } type Query { countries, continents, languages, continent, country, language }",
      "success": true,
      "latency_ms": 350
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "{ continents { code name } }"
      },
      "result_excerpt": "[{code:AF,name:Africa},{code:AN,name:Antarctica},{code:AS,name:Asia},{code:EU,name:Europe},{code:NA,name:North America},{code:OC,name:Oceania},{code:SA,name:South America}]",
      "success": true,
      "latency_ms": 120
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "{ continent(code: "EU") { name countries { name capital currency } } }"
      },
      "result_excerpt": "53 European countries with capitals and currencies",
      "success": true,
      "latency_ms": 140
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "query($code: ID!) { country(code: $code) { name capital currency languages { name } } }",
        "variables": "{"code":"TR"}"
      },
      "result_excerpt": "FAILED: Variable "$code" of required type "ID!" was not provided",
      "success": false,
      "latency_ms": 100,
      "bug": "variables string double-serialized — passed as JSON string instead of parsed object"
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "{ country(code: "TR") { name capital currency emoji languages { name } } }"
      },
      "result_excerpt": "{name:Turkey,capital:Ankara,currency:TRY,emoji:🇹🇷,languages:[{name:Turkish}]}",
      "success": true,
      "latency_ms": 110
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "{ country(code: "US") { name states { name code } } }"
      },
      "result_excerpt": "65 US states/territories with name and code",
      "success": true,
      "latency_ms": 130
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "{ languages { code name native rtl } }"
      },
      "result_excerpt": "103 languages with native names and RTL flags",
      "success": true,
      "latency_ms": 180
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "{ countries(filter: { continent: { eq: "AS" } }) { name capital currency phone continent { name } } }"
      },
      "result_excerpt": "52 Asian countries with capitals, currencies, phone codes",
      "success": true,
      "latency_ms": 200
    },
    {
      "tool": "query-graphql",
      "args": {
        "query": "mutation { updateCountry(code: "TR", name: "test") { name } }"
      },
      "result_excerpt": "Mutations are not allowed. Set ALLOW_MUTATIONS environment variable to enable mutations.",
      "success": true,
      "latency_ms": 5,
      "note": "Expected behavior — mutations correctly blocked by default"
    }
  ]
}