--- title: "Prismic MCP Server" description: "Create and publish Prismic content from AI assistants like Claude and ChatGPT, or coding agents like Claude Code, Codex, and Cursor." category: "use-prismic" lastUpdated: "2026-10-16T07:39:12.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. Coding agents like Claude Code, Codex, and Cursor use it to write content, while the [Prismic CLI](https://prismic.io/docs/cli.md) manages models and settings. # Activate Prismic MCP Prismic MCP is on by default for new repositories. The setting applies to everyone with access to the repository. [Environments](https://prismic.io/docs/environments.md) have their own setting, and a new environment takes a few minutes to get ready. If Prismic MCP is off on your production repository, new environments start with it off too. > Only repository [Administrators and Owners](https://prismic.io/docs/users.md#repository-roles) can activate Prismic MCP. If **Prismic MCP** doesn't appear in your settings, ask an Administrator to activate it. 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** If Prismic MCP is off, click **Activate**. Prismic will prepare your repository so the MCP server can search and work with its content. This can take several minutes, or longer on large repositories. # Connect to the MCP server After activation, connect your AI assistant. * **Claude:** 1. **Open the Prismic connector** Open the [Prismic connector listing](https://claude.ai/customize/connectors/id/4b1276ea-658e-436e-92da-3716e6b2c922) in Claude. 2. **Connect Prismic** Click the connect button to add Prismic to Claude. 3. **Sign in to Prismic** Claude asks you to sign in to your Prismic account. Authorize the connection to finish. **In [Claude Code](https://claude.com/product/claude-code)**: in a terminal, run the following command. `--scope user` adds the server to every project. To share it with your team, use `--scope project`, which writes a `.mcp.json` file you can commit. ```sh claude mcp add --transport http --scope user prismic https://mcp.prismic.io/mcp ``` Then, in Claude Code, run `/mcp`, select **prismic**, then **Authenticate**. * **ChatGPT:** > **Important** > > ChatGPT plugins require a paid plan, such as **Plus**, **Pro**, **Business**, **Enterprise**, or **Edu**. In a workspace, your admin controls which plugins are available. 1. **Open the Prismic plugin** Open the [Prismic plugin listing](https://chatgpt.com/plugins/plugin_asdk_app_69fb38b9480c81919e16addf9dc1ce64) in ChatGPT. 2. **Install the plugin** Click the plus button to install Prismic. 3. **Sign in to Prismic** ChatGPT asks you to connect your Prismic account, either during the install or the first time you use the plugin. Authorize the connection to finish. Once installed, start a new chat and ask ChatGPT to use Prismic, or type `@Prismic` to call it directly. **In [Codex](https://openai.com/codex/)**: in a terminal, run the following command. The server works in every project, and in the Codex app and IDE extension. ```sh codex mcp add prismic --url https://mcp.prismic.io/mcp ``` Codex opens your browser to sign in to Prismic. If you close it first, run `codex mcp login prismic`. * **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. * **Others:** Prismic works with any MCP client that supports remote servers. Follow your tool's setup guide, add a server with the following URL, and sign in to Prismic when prompted. ```plain https://mcp.prismic.io/mcp ``` * [GitHub Copilot app](https://docs.github.com/en/copilot/how-tos/github-copilot-app/customize-github-copilot-app#configuring-mcp-servers): Add Prismic as a custom HTTP server in the MCP servers settings. * [Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#using-the-copilot-mcp-add-subcommand): Add Prismic as an HTTP server with the copilot mcp add command. * [Copilot cloud agent](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers): Add Prismic to your repository's MCP configuration with a write token. * [VS Code](https://code.visualstudio.com/docs/agent-customization/mcp-servers#_add-an-mcp-server): Add Prismic as an HTTP server with the MCP: Add Server command. * [Langdock](https://docs.langdock.com/en/using-langdock/guides/integrations/mcp/mcp#getting-started): Add Prismic as an integration with Connect remote MCP. * [Vercel Connect](https://prismic.io/docs/ai.md#use-the-mcp-server-in-your-app): Use Prismic in your app on behalf of its users. # Authentication Most of the setups above sign you in as part of the connection flow. If yours didn't, your AI assistant prompts you the first time it calls a Prismic tool: click the authentication button, sign in on Prismic's login page, and authorize the connection. Either way, you only sign in once. The MCP server uses your Prismic identity, so you only have access to repositories your account can access. ## Authenticate in non-interactive environments The MCP server can be used in scripts, CI workflows, and AI agents. You may use a write token to authenticate non-interactive environments like GitHub Actions. Generate a write token with the CLI: ```sh npx prismic token create --write ``` Then, add an MCP server with these two values: * Server: `https://mcp.prismic.io/mcp` * Header: `Authorization: Bearer ` Prismic MCP must be on for the repository. See [Activate Prismic MCP](#activate-prismic-mcp). > **Caution** > > A write token is an administrator credential. Keep it secret. Do not commit it or put it in client-side code. # 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. # Deactivate Prismic MCP Repository Administrators and Owners can deactivate Prismic MCP in **Settings** > **Prismic MCP**. Prismic tools stop working on the repository immediately. It stays off until you [activate it again](#activate-prismic-mcp), which you can do at any time. Prismic prepares the repository from scratch, so it takes as long as the first activation. # Troubleshooting ## Prismic MCP is not activated If your AI assistant says Prismic MCP is not activated for a repository, ask a repository Administrator to [activate it](#activate-prismic-mcp), then try your request again. ## Prismic MCP is activating If your AI assistant says Prismic MCP is activating for a repository, Prismic is still preparing its content. Wait a few minutes, then try your request again. ## 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.