Gqai GraphQL + AI

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

FAQ from Gqai

What is the difference between Gqai and building a custom MCP server?

Gqai automatically converts your existing GraphQL queries and mutations into MCP tools, eliminating the need to write any server code or manually define tool schemas.

What are the runtime dependencies for Gqai?

Gqai is a single binary built with Go. To build from source you need Go 1.20+. After installation, no runtime dependencies are required besides your GraphQL endpoint.

Where does Gqai execute the GraphQL operations?

Gqai sends the defined GraphQL operations to the live GraphQL endpoint specified in the schema field of your .graphqlrc.yml file. It does not use a static schema file.

How do I pass authentication headers to my GraphQL endpoint?

You can add headers directly in the .graphqlrc.yml config under the schema field. Header values can also reference environment variables using ${VARNAME} or ${VARNAME:-default} syntax.

Does Gqai support GraphQL mutations as tools?

Yes. Gqai treats any GraphQL operation (query or mutation) defined in a .graphql file as a tool. Mutations with arguments become tools that accept input parameters.