Frequently Asked Questions (FAQ) about mcp4gql

Q: What is mcp4gql? A: mcp4gql is a Node.js/TypeScript server that implements the Model Context Protocol (MCP) and acts as a bridge between MCP clients (like Cursor and Claude) and GraphQL APIs.

Q: What is MCP (Model Context Protocol)? A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs), enabling AI models to access and interact with external data sources and tools.

Q: What are the key features of mcp4gql? A: Key features include MCP Server implementation, Stdio transport, a GraphQL client using axios, and tools for GraphQL schema introspection and query execution.

Q: What environment variables does mcp4gql require? A: mcp4gql requires GRAPHQL_ENDPOINT (the URL of the GraphQL API) and optionally AUTH_TOKEN (a bearer token for authentication).

Q: How do I configure Cursor to use mcp4gql? A: In Cursor settings, add a new global MCP server with the command npx, args -y mcp4gql, and set the environment variables GRAPHQL_ENDPOINT and AUTH_TOKEN.

Q: How do I configure Claude Desktop to use mcp4gql? A: In Claude Desktop settings, edit the config and add an mcpServers entry for mcp4gql with the command npx, args -y mcp4gql, and set the environment variables GRAPHQL_ENDPOINT and AUTH_TOKEN.

Q: What tools does mcp4gql expose to MCP clients? A: mcp4gql exposes introspectGraphQLSchema (for fetching the GraphQL API schema) and executeGraphQLOperation (for executing arbitrary GraphQL queries and mutations).

Q: What is UBOS, and how does it relate to mcp4gql? A: UBOS is a full-stack AI Agent Development Platform that helps orchestrate AI Agents, connect them with enterprise data, build custom AI Agents, and design Multi-Agent Systems. mcp4gql can be integrated with UBOS to provide GraphQL API access within UBOS-orchestrated AI Agent workflows.

Q: Can I use mcp4gql without UBOS? A: Yes, mcp4gql can be used independently to connect MCP clients to GraphQL APIs.

Q: What are some use cases for mcp4gql? A: Use cases include AI-powered data analysis, automated workflow orchestration, personalized recommendations, dynamic content generation, and intelligent customer support.