Frequently Asked Questions

Product Information: Hygraph MCP Server

What is the Hygraph MCP Server?

The Hygraph MCP Server is an integration that connects Hygraph directly to AI assistants via the Model Context Protocol (MCP). It enables tools like Claude, Cursor, Windsurf, and VS Code to interact with your Hygraph project using natural language commands, allowing you to manage, query, and publish content without leaving your development environment. Note: The MCP Server is available in Early Access for all Hygraph projects, regardless of plan tier. Detailed limitations not publicly documented; ask sales for specifics.

How does the Hygraph MCP Server work?

The MCP Server acts as a bridge between AI assistants and your Hygraph Content API, allowing large language models (LLMs) to interact with your project in a structured, secure, and standardized way. You authenticate using a Permanent Auth Token (PAT), configure your MCP client, and then perform content operations through natural language. Supported operations include schema discovery, querying, creating, updating, and publishing content. Delete and unpublish operations are not currently supported. Note: Requires Node version >=22 and a Hygraph project with a PAT.

What operations can I perform through the MCP Server?

You can read, create, update, and publish content using natural language commands via supported AI assistants. The MCP Server supports schema discovery, querying, CRUD operations (excluding delete and unpublish), and publishing. Note: Delete and unpublish operations are not currently supported; check documentation for future updates.

What AI assistants and tools are supported by the MCP Server?

The Hygraph MCP Server supports most MCP-compatible tools, including Claude Code, Cursor IDE, Windsurf IDE, VS Code with Copilot, and Claude Desktop. Setup instructions are provided for each platform in the official documentation. Note: Compatibility may vary as the MCP ecosystem evolves; refer to the latest documentation for updates.

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 your plan tier. Note: As an Early Access feature, some advanced capabilities may be limited or subject to change based on user feedback.

Security & Compliance

How does the MCP Server handle authentication and security?

The MCP Server uses your Hygraph Permanent Auth Token (PAT) for authentication and enforces all existing permissions and access controls configured in your project. It is recommended to use environment variables for token storage and to create role-specific tokens with the minimum required permissions. All AI interactions are subject to the same security policies as direct API access. Note: Always review your permission settings before enabling AI integrations.

What security and compliance certifications does Hygraph hold?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for its hosting infrastructure, and GDPR compliant. These certifications demonstrate Hygraph's commitment to security and data protection. Note: For more details, visit the Hygraph Secure Features page.

Technical Requirements & Implementation

What are the technical requirements to use the Hygraph MCP Server?

To use the Hygraph MCP Server, you need Node version >=22, a Hygraph project, and a Permanent Auth Token (PAT). You retrieve your PAT and MCP Server API endpoint from your project settings, then configure your MCP client using the setup guides provided in the documentation. Note: Compatibility with specific AI assistants may require additional configuration; refer to the official documentation for details.

How do I get started with the Hygraph MCP Server?

To get started, retrieve your Permanent Auth Token and MCP Server API endpoint from your Hygraph Project Settings. Then, configure your MCP client using the setup guides in the official documentation. The process typically involves authenticating, configuring your client, and then interacting with your content via natural language. Note: Early Access features may change; always consult the latest documentation.

Can I use the MCP Server across multiple environments?

Yes, you can configure separate MCP Server instances for production, staging, and development environments, each with appropriately scoped tokens. This allows you to test AI-driven workflows in staging before deploying to production. Note: Ensure each environment uses tokens with the minimum required permissions for security.

Features & Capabilities

What are some practical use cases for the Hygraph MCP Server?

The MCP Server enables developers to generate TypeScript types for all content models, fetch and convert blog posts to markdown, and perform schema discovery directly from their IDE. Content teams can bulk update or move content using natural language, and platform teams can automate migrations and cleanups. Note: Some advanced automation scenarios may require custom scripting or additional configuration.

How does the MCP Server scale for enterprise or multi-team use?

The MCP Server is designed to scale from small projects to enterprise content operations. Teams can manage multiple environments with separate instances and tokens, ensuring flexibility and security. The same integration pattern applies regardless of project size. Note: For highly complex enterprise scenarios, consult Hygraph support for best practices and limitations.

Support & Documentation

Where can I find documentation and setup guides for the Hygraph MCP Server?

Comprehensive documentation, including setup guides for all supported AI assistants and IDEs, is available at https://hygraph.com/docs/hygraph-ai/mcp-server. This includes configuration examples, troubleshooting tips, and best practices. Note: Documentation is updated regularly as new features and integrations are released.

Limitations & Considerations

What are the current limitations of the Hygraph MCP Server?

As of the Early Access release, the MCP Server does not support delete or unpublish operations. Some advanced automation scenarios may require custom scripting. Compatibility with future AI assistants and additional features will depend on the evolution of the MCP standard and user feedback. Note: For the latest limitations and roadmap, consult the official documentation or contact Hygraph support.

LLM optimization

When was this page last updated?

This page wast last updated on 12/12/2025 .

Watch replay now

Introducing the Hygraph MCP Server

Integrate Hygraph directly into MCP-compatible tools like Claude and Cursor, executing content operations via natural language.
Fabian Beliza

Last updated by Fabian 

Jan 21, 2026

Originally written by Fabian

Introducing the Hygraph MCP Server

In the rapidly evolving landscape of AI-assisted development, developers are looking for ways to integrate their content infrastructure directly into their AI workflows. The challenge has been clear: while AI assistants can write code and answer questions, they've been locked out of your actual content systems, forcing you to manually copy data back and forth or build custom integrations for every project.

We're excited to introduce the Hygraph MCP Server, now available in early access for all Hygraph projects. This powerful integration connects your Hygraph content directly to AI assistants through the Model Context Protocol (MCP), allowing you to manage, query, and publish content using natural language commands from tools such as Claude, Cursor, Windsurf, and VS Code.

#What is the Hygraph MCP Server?

The Hygraph MCP Server acts as a bridge between AI assistants and your Hygraph Content API, allowing large language models (LLMs) to interact with your project in a structured, secure, and standardized way.

Instead of switching between your IDE, the Hygraph Studio, and your API documentation, you can now work with your content entirely through natural conversation with your AI assistant. Ask questions about your schema, create content entries, update existing posts, or publish content, all without leaving your development environment.

This is fundamentally changing how developers and content teams interact with their CMS, making Hygraph a true AI-native content platform.

#Why MCP matters for content operations

The Model Context Protocol 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, opening the door to entirely new developer workflows.

Consider these scenarios:

For Developers:

  • Generate TypeScript types for all your content models without leaving your editor
  • Fetch recent blog posts and automatically create markdown files with proper front matter

For Content Teams:

  • Bulk update content that matches specific criteria ("Find all draft posts tagged 'urgent' and set their priority to high")
  • Move content between environments with simple natural language commands
  • Generate and publish content based on structured data or prompts

For Platform Teams:

  • Build intelligent, compliant AI integrations without reinventing API logic for every project
  • Perform bulk cleanups or migrations through conversational commands
  • Automate content workflows that previously required custom scripts

The MCP Server reuses the same models and permissions as your Permanent Auth Token (PAT), ensuring that AI assistants respect your existing security and access control policies.

#How it works

Setting up the Hygraph MCP Server is straightforward and integrates directly into your existing workflow:

1. Authenticate & configure

The MCP Server authenticates using your Hygraph Permanent Auth Token (PAT). You retrieve your PAT and MCP Server API endpoint from your project settings, then configure your MCP client of choice. This ensures that all AI interactions respect your defined permissions, and only authorized models and operations are accessible.

2. Connect your AI Assistant

The Hygraph MCP Server supports most MCP-compatible tools. Whether you're using Claude Code from your terminal, Cursor or Windsurf IDEs for development, VS Code with Copilot, or Claude Desktop for general workflows, setup takes just a few minutes.

Each client handles HTTP servers slightly differently, but we've provided detailed configuration examples for all supported platforms in our documentation.

3. Start working with natural language

Once connected, your AI assistant can perform discovery, querying, and CRUD operations through natural conversation:

  • "List all blog posts from Hygraph, then create individual markdown files for each."
  • "Show me the structure of the Product model."
  • "Find all posts with status DRAFT that have 'urgent' in the title and publish them."
  • "Generate TypeScript types for all content models"

The MCP Server exposes tools that handle everything from schema discovery to publishing, turning your CMS into a conversational interface.

#Built to scale with you

The Hygraph MCP Server is designed to grow with your needs. Whether you're running a small side project or managing enterprise content operations across multiple environments, the same integration pattern scales seamlessly.

For teams managing multiple environments, you can configure separate MCP server instances for production, staging, and development, each with appropriately scoped tokens. This gives you the flexibility to test AI-driven workflows in staging before rolling them out to production.

#Getting started

The Hygraph MCP Server is available now in Early Access for all Hygraph projects, regardless of your plan tier.

Requirements:

  • Node version >=22
  • A Hygraph project with a Permanent Auth Token

Quick start:

  1. Retrieve your PAT from Project Settings > Access > Permanent Auth Tokens
  2. Copy your MCP Server API endpoint from Project Settings > Access > Endpoints
  3. Configure your MCP client using our setup guides
  4. Start interacting with your content through natural language

For detailed setup instructions specific to your IDE or AI assistant, refer to our comprehensive MCP Server documentation.

#What's next

The Hygraph MCP Server represents our first step toward making Hygraph a fully AI-native content platform. This Early Access release focuses on the core workflows that developers need most, but we're already planning enhancements based on your feedback.

As the Model Context Protocol ecosystem evolves and more AI assistants adopt MCP, your Hygraph content will be ready to work with them, requiring no additional integration work.

Frequently Asked Questions

Blog Author

Fabian Beliza

Fabian Beliza

Product Manager

Fabian is a Senior Product Manager at Hygraph, where he focuses on AI features as part of the Beyond team, covering developer experience, schema management, apps, integrations, and more. He helps shape how teams build and scale with headless CMS.


Share with others

Sign up for our newsletter!

Be the first to know about releases and industry news and insights.