Connect your AI tools to Builder Publish spaces using the Model Context Protocol (MCP), an open standard that lets Large Language Models (LLMs) securely interact with your Builder content.
Note: The Builder CMS MCP server only connects to Publish Spaces.
- Within a Builder Space, go to the Integrations page and click the Connect button next to the Builder.io CMS icon.
- After connecting, access Builder content using prompts.
To connect to the Builder CMS MCP server:
- Go to Integrations.
- On the Builder.io CMS tile, click + Connect.
- In the modal that opens, choose a Publish or Hybrid Space.
- Click Connect.
Access the Builder CMS MCP server from any MCP-compatible client, including AI coding assistants, IDE extensions, or LLM-based tools.
The Builder MCP server uses standard OAuth 2.0 with dynamic client registration. When you first use the server, your MCP client will open a browser window and redirect you to Builder, where you'll be prompted to sign in and select the Space you want to work with.
This allows your AI client to access content from the correct Builder Space automatically.
Most MCP clients use a JSON configuration file to define connections. Add an entry for the Builder CMS MCP server using the following details:
- Server type: streamable HTTP
- Endpoint URL:
https://mcp.builder.io/mcp/publish
Example configuration:
{
"mcpServers": {
"builder-cms": {
"url": "https://mcp.builder.io/mcp/publish",
"transport": "http"
}
}
}Consult your MCP client's documentation for the specific configuration file location and any client-specific settings.
Claude Desktop users can add the following to their claude_desktop_config.json file to load the CMS MCP server:
{
"mcpServers": {
"builder-cms": {
"url": "https://mcp.builder.io/mcp/publish",
"transport": "http"
}
}
}GitHub Copilot users can add the following to their configuration file:
{
"mcpServers": {
"builder-cms": {
"url": "https://mcp.builder.io/mcp/publish",
"tools": ["*"]
}
}
}After connecting, test the connection with prompts, such as:
- What content models are available in this Builder Space?
- Show me all Pages in my Builder Space.
- Search for content containing 'homepage'.
After a successful connection, your client retrieves and displays your Builder content.
Within Editor AI for Publish users, or Editor AI and Builder for Hybrid users, users have access to the following information and actions.
Retrieve specific content entries by targeting a particular model and applying query filters to narrow down results.
Use this approach when you have precise criteria or know exactly what content you're looking for, such as filtering by specific field values like names, IDs, or other properties. Returns structured content data that matches your specified parameters.
Example Prompt
Browse all content entries within a specific model without applying any filters or restrictions.
Use this for getting an overview of available content, understanding the scope of a model, or when you need to see everything that exists within a particular content type before making more targeted queries.
Example Prompt
Perform text-based searches across all content entries in all models within your Builder Space. By default, only published content is searched, but you can ask for content in the Draft state to be searched as well.
Use this for discovering content when you don't know the exact model or location but have keywords or phrases to search for. Explicitly ask for the full content to be retrieved to gather complete content structure and data rather than just summary information.
Example Prompt
Generate a complete inventory of all content models that are available and accessible within your current Builder Space.
Use this to understand the content architecture of your space and discover what types of content structures are available for querying, creating, or modifying.
Example Prompt
Retrieve the detailed schema definition for any specific model, revealing the complete field structure, data types, validation rules, and relationships.
Use this to understand how content is structured before creating new entries or when you need to know what fields are available for querying and updating content.
Example Prompt
Generate a comprehensive view of your space's page structure, similar to a sitemap, showing how pages are organized hierarchically.
Reveals parent-child relationships between pages, navigation structures, and the overall site architecture, which is crucial for understanding content organization and site navigation patterns.
Example Prompt
Search through all digital assets stored in your Builder Space, including images, videos, documents, and other file types.
Automatically displays image previews inline for visual assets and makes all asset URLs clickable for easy access. Supports various search criteria including filename patterns, asset types, and metadata.
Example Prompt
Create new content entries across any available model in your Builder Space. For page-type models, includes intelligent features like automatic URL generation based on content names, ensuring proper routing and accessibility.
Handles field validation according to the model schema and provides confirmation of successful content creation.
When creating content, it is best to be explicit as to whether or not you want the content immediately published.
Example Prompt
Modify existing content entries while preserving data integrity and relationships.
After successful updates, returns comprehensive access information including direct links to the Builder editor interface and live page URLs where applicable, making it easy to review changes and continue editing work.
Example Prompt
You can also ask for changes to content entry targeting, including scheduling parameters to Schedule content.
Example Prompt
Create new content models to define the structure and fields for different types of content in your Builder Space.
Define field types, validation rules, and model properties to establish the framework for content creation. Models can be of different types including data, component, page, section, or symbol, each serving specific use cases in your content architecture.
Example Prompt
Modify existing content models to adapt to changing requirements while maintaining compatibility with existing content.
Add new fields, modify existing field properties, update validation rules, or adjust model settings. Changes are applied carefully to preserve existing content and relationships within the model structure.
Example Prompt
Retrieve all design tokens configured in your Builder Space, including colors, spacing values, and typography settings.
Use this to understand a Space's visual design system before generating or editing content, ensuring new content stays consistent with existing brand and style guidelines.
Example Prompt
Retrieve all custom components that have been registered in your Builder Space and are available for use in content entries.
Use this before creating or editing content to confirm which custom components exist and what they're called, so generated content references real, available components rather than guessing at names.
Example Prompt
Retrieve available templates, including both user-created templates and official Builder templates.
Use this as a starting point when creating new content, to avoid building common layouts from scratch.
Example Prompt
Create a reusable Symbol from a given block structure. This is a shortcut for creating content directly on the symbol model, and Symbols are automatically published once created.
Use this when a piece of content, such as a header or promo banner, needs to be reused across multiple pages and stay in sync when updated.
Example Prompt
Perform a fast, two-step search that returns matching content IDs and names first, without pulling full content data. Use the Get Builder content prompt structure afterward to fetch full details only for the entries you need.
Use this over Searching for Builder content when working with large datasets, where retrieving full content for every match would be slow or unnecessary. For example, if you need to scan hundreds of blog posts before narrowing the list to a handful.
Example Prompt
Return details about the currently authenticated user and which Builder Space the MCP session is connected to.
Use this to confirm you're operating in the correct Space and account context before making content changes. This is especially useful in multi-Space setups.
Example Prompt