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)