Return the GraphQL schema (SDL). Call this before writing queries.

Validate a GraphQL query without executing it.

Returns {"valid": bool, "errors": [...], "depth": int}. Use this to catch typos and invalid fields cheaply before calling graphql_query.

Execute a read-only GraphQL query and return {"data", "errors"}.

Select only the fields you need. Example:

query($role: Role) {
  users(role: $role) { name posts(limit: 2) { title } }
}

with variables {"role": "ADMIN"}. Mutations are rejected here.

Execute a GraphQL mutation (write operation).

Only permitted when the server is started with GRAPHMCP_ALLOW_MUTATIONS=1. Example:

mutation($input: CreatePostInput!) { createPost(input: $input) { id } }