Gqai GraphQL + AI MCP Server

What is Gqai?

Gqai is a lightweight proxy that exposes GraphQL queries and mutations as Model Context Protocol (MCP) tools for AI assistants like Claude, Cursor, and ChatGPT. It automatically generates an MCP server from your GraphQL backend using a simple configuration file and plain .graphql operation files.

How to use Gqai?

Install Gqai with go install github.com/fotoetienne/gqai@latest, then create a .graphqlrc.yml config file that points to your GraphQL endpoint and operation documents. Add your GraphQL queries/mutations in .graphql files, configure Gqai as an MCP server in your client’s mcp.json, and your AI can call the operations as tools. You can also test tools via the CLI with gqai tools/call <toolname>.

Key features of Gqai

• Define tools using standard GraphQL operations
• Automatically discovers operations from .graphqlrc.yml
• Tool metadata compatible with OpenAI function calling / MCP
• Supports environment variables in configuration and headers
• No code or extra infrastructure required

Use cases of Gqai

• Expose a GraphQL API as a set of AI-callable tools for natural language queries
• Let AI assistants fetch data from your GraphQL backend without writing custom MCP servers
• Quickly prototype AI integrations by reusing existing GraphQL operations
• Securely pass authentication tokens via environment variables in headers