mcp-graphql-forge

Overview

MCP GraphQL Forge is a specialized MCP server that bridges GraphQL APIs with AI tools by automatically generating MCP tools from GraphQL schema introspection. It features dual transport modes (stdio for AI integration, HTTP for development), comprehensive parameter validation to prevent GraphQL errors, and an intelligent field selection system that handles circular references and optimizes query structure. The server supports both pre-introspection and schema caching for consistent performance, along with experimental authentication support.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query_user

  Execute GraphQL query to retrieve a user by ID

  Try:Get user with ID 123Try:Fetch user details for user@example.com
• query_articles

  Execute GraphQL query to retrieve articles with optional filters

  Try:List all articlesTry:Get articles filtered by category 'technology'
• mutation_createUser

  Execute GraphQL mutation to create a new user

  Try:Create a new user with name John DoeTry:Add user to the system with email user@example.com
• query_posts

  Execute GraphQL query to retrieve blog posts with optional filters

  Try:Get all published postsTry:Fetch posts by author ID 456
• query_post

  Execute GraphQL query to retrieve a single post by slug

  Try:Get post with slug 'getting-started'Try:Fetch the post titled 'Introduction'
• query_authors

  Execute GraphQL query to retrieve all authors

  Try:List all authorsTry:Get all author information
• mutation_createPost

  Execute GraphQL mutation to create a new blog post

  Try:Create a new post titled 'Hello World'Try:Add blog post with content about MCP servers
• mutation_publishPost

  Execute GraphQL mutation to publish a post by ID

  Try:Publish post with ID 789Try:Make post with ID 123 publicly visible
• query_products

  Execute GraphQL query to retrieve products with optional filters

  Try:List all available productsTry:Get products in category 'electronics'
• mutation_productCreate

  Execute GraphQL mutation to create a new product

  Try:Add a new product 'Wireless Headphones'Try:Create product with SKU 12345
• query_orders

  Execute GraphQL query to retrieve orders with optional filters

  Try:List all recent ordersTry:Get orders for customer ID 456
• mutation_orderUpdate

  Execute GraphQL mutation to update an existing order

  Try:Update order 789 with new shipping addressTry:Change payment method for order 456

Comparable tools

Installation

npx @smithery/cli install @toolprint/mcp-graphql-forge --client claude

# npm install
npm install -g @toolprint/mcp-graphql-forge

{
  "mcpServers": {
    "mcp-graphql-forge": {
      "command": "npx",
      "args": [
        "-y",
        "@toolprint/mcp-graphql-forge"
      ],
      "env": {
        "GRAPHQL_ENDPOINT": "https://your-api.com/graphql",
        "GRAPHQL_AUTH_HEADER": "Bearer YOUR_TOKEN"
      }
    }
  }
}

FAQ

How does it handle GraphQL introspection?

The server automatically introspects the GraphQL API to generate tools. You can pre-generate and cache schemas using the 'introspect' command for faster startup times.

Can it handle authentication?

Yes, it supports authentication through environment variables like GRAPHQL_AUTH_HEADER. Custom headers can be configured with GRAPHQL_HEADER_* prefixes.

Compare mcp-graphql-forge with