hasura-mcp-server

MCP server for Hasura GraphQL, runnable via npx hasura-mcp-server.

Requirements

• Node.js 18+
• Hasura GraphQL endpoint + admin secret

Usage

export HASURA_GRAPHQL_ENDPOINT="https://your-hasura/v1/graphql"
 
npx hasura-mcp-server --x-hasura-admin-secret=your-admin-secret

You can also pass values directly:

npx hasura-mcp-server --endpoint https://your-hasura/v1/graphql --x-hasura-admin-secret your-admin-secret

Any other --key value or --key=value args are forwarded as headers:

npx hasura-mcp-server --endpoint https://your-hasura/v1/graphql \\
  --x-hasura-admin-secret=secret \\
  --x-hasura-role=readonly \\
  --authorization="Bearer token"

Tools

• health_check
• list_tables
• describe_table
• list_root_fields
• describe_graphql_type
• preview_table_data
• aggregate_data
• run_graphql_query

Note: mutation operations are not allowed.

Resource

• hasura://schema (GraphQL introspection schema)