Integrations
Exposes GraphQL operations from any GraphQL backend as MCP tools, allowing AI agents to execute queries and mutations against GraphQL APIs using the operations defined in .graphql files.
Allows ChatGPT to utilize GraphQL operations as tools through OpenAI's function calling capability, enabling interaction with any GraphQL API.
gqai
graphql → ai
gqai is a lightweight proxy that exposes GraphQL operations as
Model Context Protocol (MCP) tools for AI like
Claude, Cursor, and ChatGPT.
Define tools using regular GraphQL queries/mutations against your GraphQL backend, and gqai automatically
generates an MCP server for you.
🔌 Powered by your GraphQL backend
⚙️ Driven by .graphqlrc.yml
+ plain .graphql
files
✨ Features
- 🧰 Define tools using GraphQL operations
- 🗂 Automatically discover operations from
.graphqlrc.yml
- 🧾 Tool metadata compatible with OpenAI function calling / MCP
🛠️ Installation
🚀 Quick Start
- Create a .graphqlrc.yml:
This file tells gqai where to find your GraphQL schema and operations.
Note: The schema
parameter tells gqai where to execute the operations. This must be a live server rather than a static schema file
- Add a GraphQL operation
get_all_films.graphql
:
- Add gqai to your
mcp.json
file:
That's it! Your AI model can now call the get_all_films
tool.
Usage
Configuration
GraphQL Config
The graphql config
file is a YAML file that defines the GraphQL endpoint and the operations
you want to expose as tools. It should be named .graphqlrc.yml
and placed in the root of your project.
The schema
field specifies the GraphQL endpoint, and the documents
field specifies the directory where your GraphQL operations are located.
In this example, the operations
directory contains all the GraphQL operations you want to expose as tools.
Operations are defined in .graphql
files, and gqai will automatically discover them.
Headers
You can also specify headers to be sent with each request to the GraphQL endpoint. This is useful for authentication or other custom headers.
MCP Configuration
Claude Desktop
To use gqai with Claude Desktop, you need to add the following configuration to your mcp.json
file:
🧪 CLI Testing
Call a tool via CLI to test:
This will execute the get_all_films
tool and print the result.
Call a tool with arguments:
Create a GraphQL operation that takes arguments, and these will be the tool inputs:
get_film_by_id.graphql
:
Call the tool with arguments:
This will execute the get_film_by_id
tool with the provided arguments.
Development
Prerequisites
- Go 1.20+
Build
Test
Format
Run MCP server
Run CLI
About GQAI
🤖 Why gqai?
gqai makes it easy to turn your GraphQL backend into a model-ready tool layer — no code, no extra infra. Just define your operations and let AI call them.
📜 License
MIT — fork it, build on it, all the things.
👋 Author
Made with ❤️ and 🤖vibes by Stephen Spalding && <your-name-here>
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
gqai
Related MCP Servers
- -securityAlicense-qualityEnables AI assistants to interact with and manage Google Cloud Platform resources including Compute Engine, Cloud Run, Storage, BigQuery, and other GCP services through a standardized MCP interface.Last updated -1PythonMIT License
- GoMIT License
- PythonMIT License
- Python