Gqai GraphQL + AI
About
Turn any GraphQL endpoint into a set of MCP tools
Details
- Author
- fotoetienne
- GitHub stars
- 23
- Downloads
- 233
- Categories
- Other, AI
Jump to
- 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
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>.
gqai
graphql → aigqai 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
go install github.com/fotoetienne/gqai@latest
🚀 Quick Start
1. Create a .graphqlrc.yml:schema: https://graphql.org/graphql/
documents: .
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
2. Add a GraphQL operation
get_all_films.graphql:
```graphql
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
