Introducing v0.2.0

On April 24, 2025, we released v0.2.0 of mcp-graphql-forge, a significant step forward in making this tool accessible to all developers regardless of their operating system. This rapid follow-up to our initial launch focuses on cross-platform compatibility and production-ready resilience.

What’s New

Windows Compatibility

The headline feature in v0.2.0 is full Windows support. For the first time, users on Windows can now run mcp-graphql-forge alongside their macOS and Linux counterparts. This release includes pre-built binaries for Windows (both 386 and amd64 architectures), closing a critical gap from our initial release.

The underlying implementation now detects the operating system at runtime and uses the appropriate shell for executing authentication commands:

  • Windows: Uses cmd /C for shell command execution
  • Unix-like systems (macOS, Linux): Continues using sh -c

Enhanced Error Handling

We’ve significantly improved how mcp-graphql-forge handles problems. The v0.2.0 release provides clearer feedback when things go wrong, reducing frustration and speeding up debugging:

  • Token command failures now include stderr output, making it easier to diagnose authentication issues
  • GraphQL execution errors return error results instead of crashing the application
  • Configuration loading fails gracefully with descriptive error messages
  • Individual tool configuration errors log warnings and continue loading other tools, rather than blocking the entire server

Why It Matters

This release represents a commitment to production readiness. By making mcp-graphql-forge truly cross-platform and resilient to misconfiguration, we’ve lowered the barrier to entry for teams working in heterogeneous environments.

Windows developers can now integrate GraphQL APIs into their AI agent workflows without needing workarounds or compatibility layers. The improved error handling means less time debugging configuration files and more time building integrations that work.

Installation & Upgrade

First-Time Installation

Download the pre-built binary for your platform from the v0.2.0 release page:

  • macOS: Choose darwin-amd64 (Intel) or darwin-arm64 (Apple Silicon)
  • Linux: Choose linux-amd64, linux-arm64, or linux-386
  • Windows: Choose windows-amd64 (most modern systems) or windows-386

Each release includes MD5 and SHA256 checksums for verification.

Upgrading from v0.1.0

macOS and Linux users upgrading from v0.1.0 will find this release fully backward compatible—no configuration changes required. We recommend upgrading if you’ve experienced crashes or unclear error messages, as the improved error handling will provide better diagnostics.

Getting Started

mcp-graphql-forge turns any GraphQL endpoint into an MCP (Model Context Protocol) server through simple YAML configuration. Create a forge.yaml file specifying your endpoint and authentication command:

name: "ExampleServer"
version: "0.2.0"
url: "https://api.github.com/graphql"
token_command: "gh auth token"

Then define individual tools in separate YAML files, specifying GraphQL queries with their parameters. Set the FORGE_CONFIG environment variable to point to your configuration folder, and you’re ready to go.

Transparency Note

This release announcement was AI-generated using the unsloth/Qwen3.5-122B-A10B-GGUF:Q4_K_M model. It was generated on March 17, 2026, by release-storyteller, based on the official v0.2.0 release of mcp-graphql-forge from UnitVectorY-Labs/mcp-graphql-forge.