Prismic MCP Server
Last updated
The Prismic MCP server lets AI assistants work directly with your Prismic content. You can search documents, read and create content, upload assets, and manage releases from a conversation with Claude or ChatGPT.
Activate Prismic MCP
Before connecting Claude or ChatGPT, activate Prismic MCP on each repository you want your assistant to use.
Open your repository
In Prismic, open the repository you want to use with MCP.
Open Prismic MCP settings
Go to Settings > Prismic MCP.
Activate MCP
Click Activate. Prismic will prepare your repository so the MCP server can search and work with its content. This can take a few minutes.
Connect to the MCP server
The MCP server URL is:
https://mcp.prismic.io/mcpAfter activation, add this URL to your AI assistant.
Open connectors
In Claude, navigate to Settings > Connectors.
Add a custom connector
At the bottom of the page, click Add custom connector.
Configure the connector
Enter a name for the connector and paste the following URL in the Remote MCP server URL field:
https://mcp.prismic.io/mcpSave the connector
Click Add. Claude will register the Prismic MCP server and its tools.
Enable Developer Mode
In ChatGPT, navigate to Settings > Apps > Advanced settings and toggle Developer mode on. Until an official Prismic app is available in ChatGPT, Developer mode is how you add the Prismic MCP server.
Create a new app
Navigate back to Settings > Apps and click Create app.
Configure the app
Fill in the following:
- Name: Prismic
- Description: Prismic MCP Server
- MCP Server URL:
https://mcp.prismic.io/mcp - Authentication: OAuth
Confirm and create
Check I understand and want to continue, then click Create. ChatGPT will connect to the Prismic MCP server.
Authentication
When you first use the Prismic MCP server, your AI assistant will prompt you to authenticate. Click the authentication button to be redirected to Prismic’s login page. Sign in with your Prismic account and the connection will be established.
The MCP server uses your Prismic identity, so you only have access to repositories your account can access.
Available tools
The MCP server exposes the following tools. Your AI assistant calls these automatically based on your prompts.
Discovery
| Tool | Description |
|---|---|
list_repositories | List all Prismic repositories you have access to. Called first to discover available repositories. |
list_custom_types | List all custom types (content models) in a repository with their id, label, and format. |
list_shared_slices | List all shared slices in a repository with their variation names. |
list_locales | List all locales configured in a repository. |
list_releases | List all releases in a repository, newest first. |
list_document_versions | List every version of a document, including drafts, published, archived, and release versions. |
Read
| Tool | Description |
|---|---|
search_documents | Search documents by keywords with optional filters for custom type, locale, status, and tags. Returns metadata, not full content. |
search_assets | Search the asset library by keyword. A single query matches against filename, alt text, notes, and credits. Returns previews. |
get_document | Fetch a document’s metadata and full content. Supports reading from a specific version or release. |
get_custom_type | Fetch a custom type’s full field model and an empty content template for creating documents. |
get_shared_slice | Fetch a shared slice’s full model with all variations and ready-to-use empty variation bodies. |
Write
| Tool | Description |
|---|---|
create_release | Create a new empty release. Returns its id for use with create_document and update_document. |
create_document | Create a new document inside a release. Missing fields are filled with model defaults. |
update_document | Update a document into a release with full content. The new version is branched from a base version. |
upload_asset | Fetch an asset from a URL and upload it to the repository’s asset library. Returns the Prismic CDN url for use in documents. |
Example prompts
You can use the following prompts once connected to Prismic.
Explore your content
What repositories do I have access to in Prismic?Show me the content types and locales configured in my-website.Search and read
Find all blog posts about product updates in my-website.Show me the content of the homepage.Create and edit content
Create a new blog post about our latest feature release.On all blog posts about ABM, update the CTA card to promote our new feature.
Make each one relevant to the article.Rewrite the hero description on the pricing page to be more concise.The AI assistant reads the document, proposes changes, and saves everything to a release in Prismic for you to review.
Troubleshooting
The connector isn’t working
If the Prismic connector stops working — for example, tools fail with authentication errors, or it stops responding after working previously — and removing and re-adding it doesn’t fix the problem, your Prismic authentication session may be stuck. Your AI assistant reuses that session each time you reconnect, so the bad state persists.
To reset it:
- Visit
https://prismic-auth.eu.auth0.com/v2/logoutto sign out of Prismic’s authentication server. - In your AI assistant, remove the Prismic connector and add it again.
- Sign in when prompted.