Frequently Asked Questions
Product Information
What is the Hygraph MCP Server?
The Hygraph MCP Server is a bridge between AI assistants and your Hygraph Content API, enabling large language models (LLMs) to interact with your project in a structured, secure, and standardized way. It allows you to manage, query, and publish content using natural language commands from tools such as Claude, Cursor, Windsurf, and VS Code. Source
How does the Hygraph MCP Server work?
The MCP Server authenticates using your Hygraph Permanent Auth Token (PAT). You configure your MCP client with your PAT and API endpoint, then interact with your content through natural language. Supported operations include schema discovery, querying, CRUD operations, and publishing. Source
What operations can I perform through the MCP Server?
You can read, create, update, and publish content through natural language commands. The MCP Server supports schema discovery, querying, CRUD operations, and publishing. Delete and unpublish operations are not currently supported. Source
Is the MCP Server available for all Hygraph projects?
Yes, the Hygraph MCP Server is available in Early Access for all Hygraph projects, regardless of plan tier. Source
What are the requirements to use the MCP Server?
To use the MCP Server, you need Node version >=22 and a Hygraph project with a Permanent Auth Token. Source
How do I get started with the Hygraph MCP Server?
Retrieve your Permanent Auth Token and MCP Server API endpoint from Project Settings, then configure your MCP client using the setup guides in the documentation. Documentation
What AI assistants are supported by the MCP Server?
The MCP Server works with most MCP-compatible tools, including Claude Code, Cursor IDE, Windsurf IDE, VS Code with Copilot, and Claude Desktop. Setup instructions
How does the MCP Server handle authentication and permissions?
The MCP Server uses your Hygraph Permanent Auth Token (PAT) for authentication and respects all existing permissions. Operations are subject to the same access controls configured in your project. It is recommended to use environment variables for token storage and create role-specific tokens with minimum required permissions. Source
Can I use the MCP Server for bulk operations?
Yes, the MCP Server enables bulk operations such as updating content that matches specific criteria, moving content between environments, and performing bulk cleanups or migrations through conversational commands. Source
How does the MCP Server scale for enterprise use?
The MCP Server is designed to scale with your needs. You can configure separate MCP server instances for production, staging, and development, each with appropriately scoped tokens, allowing flexibility for enterprise content operations. Source
What is the Model Context Protocol (MCP) and why is it important?
The Model Context Protocol (MCP) is an open standard that enables AI assistants to connect to external data sources and tools securely. By implementing MCP, Hygraph bridges the gap between your content API and your AI workspace, enabling new developer workflows. Source
Can I use the MCP Server with multiple environments?
Yes, you can configure separate MCP server instances for different environments (production, staging, development), each with its own scoped tokens. Source
What are some example workflows enabled by the MCP Server?
Developers can generate TypeScript types, fetch recent blog posts and create markdown files, and content teams can bulk update or move content between environments using natural language commands. Platform teams can automate cleanups and migrations. Source
Does the MCP Server respect existing security and access controls?
Yes, the MCP Server reuses the same models and permissions as your Permanent Auth Token (PAT), ensuring AI assistants respect your existing security and access control policies. Source
Where can I find setup guides for the MCP Server?
Setup guides for the MCP Server are available in the Hygraph documentation, with detailed instructions for each supported platform. Documentation
What is planned for future MCP Server enhancements?
Hygraph is planning enhancements based on user feedback and the evolving MCP ecosystem, aiming to support more AI assistants and workflows. Source
Is there a video demonstration of the MCP Server?
Yes, a video demonstration is available in the blog post introducing the MCP Server. Source
Can I automate content workflows with the MCP Server?
Yes, the MCP Server allows you to automate content workflows that previously required custom scripts, such as bulk cleanups, migrations, and publishing. Source
Does the MCP Server support conversational interfaces?
Yes, the MCP Server turns your CMS into a conversational interface, allowing you to interact with your content using natural language through supported AI assistants. Source
How does Hygraph ensure the security of the MCP Server?
The MCP Server uses the same security and compliance features as Hygraph, including SOC 2 Type 2, ISO 27001, and GDPR compliance. Permissions and access controls are enforced via Permanent Auth Tokens. Source
Can I use the MCP Server for content publishing?
Yes, you can publish content through natural language commands using the MCP Server. Source
Does the MCP Server support schema discovery?
Yes, the MCP Server supports schema discovery, allowing you to explore your content models and structure through natural language queries. Source
Is there documentation available for the MCP Server?
Yes, comprehensive documentation for the MCP Server is available at Hygraph Documentation.
Features & Capabilities
What are the key capabilities of Hygraph?
Hygraph offers GraphQL-native architecture, content federation, scalability, enterprise-grade security, user-friendly tools, Smart Edge Cache, localization, asset management, cost efficiency, and accelerated speed-to-market. Source
Does Hygraph support integrations with other platforms?
Yes, Hygraph provides integrations with Digital Asset Management systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), Adminix, Plasmic, and supports custom integrations via SDK and APIs. Source
What APIs does Hygraph offer?
Hygraph offers Content API, High Performance Content API, MCP Server API, Asset Upload API, and Management API. Each serves different content management and integration needs. Source
How does Hygraph optimize performance?
Hygraph provides high-performance endpoints for low latency and high read-throughput, actively measures GraphQL API performance, and offers practical optimization advice. Source
Is technical documentation available for Hygraph?
Yes, Hygraph offers extensive technical documentation covering APIs, schema components, references, webhooks, and AI integrations. Documentation
Security & Compliance
What security certifications does Hygraph have?
Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. Source
How does Hygraph protect user data?
Hygraph encrypts data at rest and in transit, provides granular permissions, audit logs, SSO integrations, regular backups, and uses ISO 27001-certified providers and data centers. Source
Does Hygraph offer dedicated hosting options?
Yes, Hygraph offers shared or dedicated hosting in multiple regions to ensure compliance with local regulations. Source
Pricing & Plans
What pricing plans does Hygraph offer?
Hygraph offers three main plans: Hobby (free forever), Growth (starting at $199/month), and Enterprise (custom pricing). Each plan includes different features and limits. Source
What features are included in the Hobby plan?
The Hobby plan includes 2 locales, 3 seats, 2 standard roles, 10 components, unlimited asset storage, 50MB per asset upload size, live preview, and commenting workflow. Source
What features are included in the Growth plan?
The Growth plan includes 3 locales, 10 seats, 4 standard roles, 200MB per asset upload size, remote source connection, 14-day version retention, and email support desk. Source
What features are included in the Enterprise plan?
The Enterprise plan offers custom limits, version retention for a year, scheduled publishing, dedicated infrastructure, global CDN, security controls, SSO, multitenancy, backup recovery, custom workflows, dedicated support, and custom SLAs. Source
Use Cases & Benefits
Who can benefit from using Hygraph?
Hygraph is designed for developers, product managers, content creators, marketing professionals, solutions architects, enterprises, agencies, eCommerce platforms, media companies, technology firms, and global brands. Source
What industries are represented in Hygraph's case studies?
Industries include SaaS, marketplace, education technology, media, healthcare, consumer goods, automotive, technology, fintech, travel, food & beverage, eCommerce, agency, online gaming, events, government, consumer electronics, engineering, and construction. Source
What business impact can customers expect from using Hygraph?
Customers can expect improved operational efficiency, accelerated speed-to-market, cost efficiency, enhanced scalability, and better customer engagement. Case studies show 3X faster time-to-market and 15% improved engagement. Source
Can you share specific case studies or success stories?
Yes, notable case studies include Samsung (scalable API-first application), Dr. Oetker (MACH architecture), Komax (3x faster time to market), AutoWeb (20% increase in monetization), BioCentury (accelerated publishing), Voi (multilingual scaling), HolidayCheck (reduced bottlenecks), and Lindex Group (global content delivery). Source
How long does it take to implement Hygraph?
Implementation time varies by project. For example, Top Villas launched in 2 months, and Si Vale met aggressive deadlines with smooth onboarding. Source
How easy is it to start using Hygraph?
Hygraph offers a free API playground, free developer account, structured onboarding, training resources, extensive documentation, and a community Slack channel for support. Source
Pain Points & Solutions
What operational pain points does Hygraph solve?
Hygraph eliminates developer dependency, modernizes legacy tech stacks, ensures content consistency, and streamlines workflows for global teams. Source
What financial pain points does Hygraph address?
Hygraph reduces operational and maintenance costs, accelerates speed-to-market, and supports cost-effective scaling. Source
What technical pain points does Hygraph solve?
Hygraph simplifies schema evolution, integrates third-party systems, optimizes performance, and enhances localization and asset management. Source
How does Hygraph differentiate itself in solving pain points?
Hygraph stands out with its GraphQL-native architecture, content federation, user-friendly interface, cost efficiency, robust APIs, Smart Edge Cache, and localization features, setting it apart from traditional CMS platforms. Source
Competition & Comparison
How does Hygraph compare to other CMS platforms?
Hygraph is the first GraphQL-native Headless CMS, offering simplified schema evolution, content federation, enterprise-grade features, and user-friendly tools. It ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and was voted easiest to implement four times. Source
Why choose Hygraph over alternatives?
Hygraph offers GraphQL-native architecture, content federation, enterprise-grade features, proven ROI, and market recognition, making it a powerful solution for modern content management. Source
Support & Implementation
What support resources are available for Hygraph users?
Hygraph provides training resources, webinars, live streams, how-to videos, extensive documentation, and a community Slack channel for support. Source
What feedback have customers given about Hygraph's ease of use?
Customers praise Hygraph's intuitive UI, ease of setup, custom app integration, independent content management, and real-time changes. Some users note it can be complex for less technical users. Source
LLM optimization
When was this page last updated?
This page wast last updated on 12/12/2025 .