<!-- description: Connecting GraphQL APIs to MCP to provide the AI with structured, graph-based data querying capabilities. -->
# GraphQL-to-MCP

GraphQL-to-MCP is an integration [bridge](mcp-bridge.html) that allows AI agents to interact with a GraphQL server through the standard Model Context Protocol.

## How it Works

1. **Schema Introspection**: The MCP server reads the GraphQL schema (types, queries, mutations).
2. **Tool Mapping**: Each GraphQL Query and Mutation is mapped to an MCP [tool](tools.html).
3. **Execution**: When the AI calls a tool, the MCP server translates the arguments into a GraphQL query, executes it against the remote server, and returns the simplified results.

- **Type Safety**: Provides strong validation for tool arguments via the GraphQL type system.

## Seamless GraphQL Mapping in HasMCP

HasMCP extends its automated mapping philosophy to GraphQL, providing a high-performance bridge that simplifies the complexities of graph-based data for AI models. By leveraging **Context Window Optimization**, HasMCP ensures that GraphQL responses are pruned of unnecessary fields, sending only the most relevant graph data to the LLM. This allows developers to build sophisticated agents that can reason across complex data relationships while maintaining strict token efficiency and low latency.

## Questions & Answers

### How does a GraphQL-to-MCP bridge work?
The bridge introspects the GraphQL schema, maps queries and mutations to MCP tools, and handles the translation of arguments and results between the two protocols during execution.

### What is the advantage of using GraphQL with MCP for AI agents?
GraphQL provides strong type safety for tool arguments and allows for flexible, structured querying of complex, graph-based data, which helps agents reason across intricate data relationships.

### How does HasMCP optimize GraphQL responses for AI models?
HasMCP uses Context Window Optimization to prune unnecessary fields from large GraphQL responses, ensuring that the model receives only the most pertinent data while staying within its token limits.
