--- title: "Prismic MCP Server" description: "Connect AI assistants like Claude and ChatGPT to your Prismic content using the MCP server." category: "use-prismic" lastUpdated: "2026-08-06T14:49:58.000Z" --- The Prismic MCP server lets AI assistants work directly with your Prismic content. You can search documents, read and create content, upload assets, manage releases, and publish them 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. 1. **Open your repository** In [Prismic](https://prismic.io/dashboard), open the repository you want to use with MCP. 2. **Open Prismic MCP settings** Go to **Settings** > **Prismic MCP**. 3. **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: ```plain https://mcp.prismic.io/mcp ``` After activation, add this URL to your AI assistant. * **Claude:** 1. **Open connectors** In [Claude](https://claude.ai), navigate to **Settings** > **Connectors** > **Customize**. 2. **Add a custom connector** At the bottom of the page, click **Add custom connector**. 3. **Configure the connector** Enter a name for the connector and paste the following URL in the **Remote MCP server URL** field: ```plain https://mcp.prismic.io/mcp ``` 4. **Save the connector** Click **Add**. Claude will register the Prismic MCP server and its tools. * **ChatGPT:** > **Important** > > ChatGPT MCP support requires a **Plus**, **Pro**, **Team**, **Enterprise**, or **Edu** plan. 1. **Enable Developer Mode** In [ChatGPT](https://chatgpt.com), 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. 2. **Create a new app** Navigate back to **Settings** > **Apps** and click **Create app**. 3. **Configure the app** Fill in the following: * **Name**: Prismic * **Description**: Prismic MCP Server * **MCP Server URL**: `https://mcp.prismic.io/mcp` * **Authentication**: OAuth 4. **Confirm and create** Check **I understand and want to continue**, then click **Create**. ChatGPT will connect to the Prismic MCP server. * **GitHub Copilot:** These steps use the [GitHub Copilot app](https://github.com/features/ai/github-app). See below for VS Code and Copilot CLI. 1. **Open MCP settings** In the GitHub Copilot app, go to **Settings** > **MCP servers**. 2. **Add a custom server** Click **+ Add server**, then **+ Add custom server**. 3. **Configure the server** Enter a server name, select **HTTP**, and paste the following URL: ```plain https://mcp.prismic.io/mcp ``` 4. **Add the server and sign in** Click **Add server**. Copilot opens your browser to sign in to Prismic. Once you authorize the connection, Copilot discovers the Prismic tools. **In VS Code**: open the Command Palette (**⇧⌘P** on macOS, **Ctrl+Shift+P** on Windows and Linux) and run **MCP: Add Server**. Choose **HTTP**, paste the URL below, and name the server `prismic`. Pick **Global** to use it in every project, or **Workspace** to share it with your team through a `.vscode/mcp.json` file you can commit. ```plain https://mcp.prismic.io/mcp ``` VS Code opens the configuration file with the new entry. Click **Start** above it to connect and sign in — your browser opens so you can authorize the connection. VS Code Insiders works the same way. You can also skip the guided flow and edit the configuration file directly. Run **MCP: Open User Configuration** (or **MCP: Open Workspace Folder MCP Configuration** for the shared `.vscode/mcp.json`) and add Prismic to the `servers` object: ```json filename=mcp.json { "servers": { "prismic": { "type": "http", "url": "https://mcp.prismic.io/mcp" } } } ``` Save the file, then click **Start** above the `prismic` entry to connect and sign in. **In [Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli)**: run the following command. The CLI and the Copilot app share the same configuration, so the server is available in both. ```sh copilot mcp add --transport http prismic https://mcp.prismic.io/mcp ``` > **Important** > > Copilot's cloud agent and code review don't support MCP servers that authenticate with OAuth, so they can't use the Prismic MCP server. * **Cursor:** 1. **Open MCP settings** In Cursor, open **Cursor Settings** and go to **Tools & MCPs**. You can also click **Customize** on Cursor's main screen and select **MCP**. 2. **Create a new server** Click **New MCP Server**. Cursor opens `~/.cursor/mcp.json`, which makes the server available in every project. To share the server with your team instead, create a `.cursor/mcp.json` file in your project and commit it. 3. **Add the Prismic MCP server** Add Prismic to the `mcpServers` object: ```json filename=mcp.json { "mcpServers": { "Prismic": { "url": "https://mcp.prismic.io/mcp" } } } ``` 4. **Sign in to Prismic** Save the file. Prismic appears in **Tools & MCPs** marked **Needs authentication**. Click it and authorize the connection in your browser. Cursor then lists the Prismic tools. # 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. | | `publish_release` | Publish a pending release, making all of its documents live. Requires a Publisher (Manager) role. Irreversible. | > All write operations save changes to a [release](https://prismic.io/docs/releases.md). Prefer reviewing staged changes and publishing from the Prismic dashboard. `publish_release` is available when you explicitly ask your assistant to publish. Migration releases cannot be published via MCP. # Example prompts You can use the following prompts once connected to Prismic. ## Explore your content ```md filename=Prompt What repositories do I have access to in Prismic? ``` ```md filename=Prompt Show me the content types and locales configured in my-website. ``` ## Search and read ```md filename=Prompt Find all blog posts about product updates in my-website. ``` ```md filename=Prompt Show me the content of the homepage. ``` ## Create and edit content ```md filename=Prompt Create a new blog post about our latest feature release. ``` ```md filename=Prompt On all blog posts about ABM, update the CTA card to promote our new feature. Make each one relevant to the article. ``` ```md filename=Prompt 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. ## Publish a release ```md filename=Prompt Publish the release you just created for the homepage updates. ``` The AI assistant can't unpublish or undo a publish. Ask for it explicitly after reviewing the staged changes. Your account needs a Publisher (Manager) role. # 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: 1. Visit [`https://prismic-auth.eu.auth0.com/v2/logout`](https://prismic-auth.eu.auth0.com/v2/logout) to sign out of Prismic's authentication server. 2. In your AI assistant, remove the Prismic connector and add it again. 3. Sign in when prompted.