---
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-05-22T11:39:57.000Z"
---

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.

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**.

  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.

# 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. |

> All write operations save changes to a [release](https://prismic.io/docs/releases.md). Nothing is published directly from the MCP server. A human publishes the release from the Prismic dashboard.

# 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.

# 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.