A .graphql file becomes a tool
The operation name is the tool name, the comment above it is the description an agent reads, and the variables are the input schema.
The operations are trusted documents
The repository holds the list of queries that exist, a pull request reviews each one, and the schema stays out of the agent's context.
Over MCP, or in process
The MCP starter serves the tools to any MCP client. The in-process starter hands them to Spring AI inside the application itself.