Released on June 25, 2025, mcp-graphql-forge v0.6.0 brings significant improvements to how your GraphQL tools are described and handled by Model Context Protocol (MCP) clients. This release focuses on enhancing tool metadata, providing better safety hints, and streamlining the configuration process.

What’s new

The highlight of this release is the introduction of Tool Annotations. You can now enrich your tool definitions in YAML with an annotations section to provide critical context to the AI:

  • Custom Titles: Use the title field to give your tools human-readable names, making them more intuitive for users and AI agents.
  • Behavioral Hints:
    • readOnlyHint: Mark tools that only fetch data, signaling to the client that no state changes will occur.
    • destructiveHint: Explicitly flag tools that perform deletions or critical updates, allowing clients to implement extra safety checks.
    • idempotentHint: Indicate tools that can be safely called multiple times without changing the result.
    • openWorldHint: Signal when a tool interacts with external entities beyond the immediate system.

Additionally, we’ve updated the core engine to Go 1.24.4 and bumped mcp-go to v0.32.0 for better performance and stability. We have also added a dedicated Releases section to our documentation, making it easier than ever to get the server up and running.

Why it matters

For those building complex AI agents, the difference between a “safe” and a “destructive” tool is paramount. By providing these hints via annotations, you empower the MCP client to make smarter decisions about when to execute a tool and when to ask for human confirmation. This reduces the risk of accidental data loss and improves the overall reliability of the agent’s interactions with your GraphQL API.

Furthermore, the removal of the version field from forge.yaml simplifies your configuration. By moving versioning to the build process, we’ve removed a redundant step from your setup, allowing you to focus entirely on defining your tools.

Getting Started

Upgrading to v0.6.0 is straightforward. You can download the pre-compiled binaries for macOS, Linux, or Windows directly from the GitHub Releases page.

Alternatively, if you prefer using Go, you can install the latest version with a single command:

go install github.com/UnitVectorY-Labs/mcp-graphql-forge@latest

If you have existing forge.yaml files, they will continue to work perfectly; any version fields will simply be ignored.

This post was AI-generated using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. It is based on the v0.6.0 release of the mcp-graphql-forge repository, generated on April 13, 2026. Author: release-storyteller