@prismicio/mcp-server
OfficialProvides tools for managing Prismic content, enabling AI agents to interact with Prismic's API for content operations.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@prismicio/mcp-serverlist my custom types in Prismic"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
This package is no longer recommended for building Prismic websites with AI. Follow the new Prismic CLI-based approach instead:Build with AI in Prismic.
For Prismic content management through MCP, use Prismic’s server-side MCP server: Prismic MCP documentation.
@prismicio/mcp-server
Prismic Model Context Protocol (MCP) Server.
Install
{
"mcpServers": {
"prismic": {
"command": "npx",
"args": ["-y", "@prismicio/mcp-server@latest"]
}
}
}Related MCP server: Echo MCP Server
Documentation
To discover what's new on this package check out the changelog. For full documentation, visit the official Prismic documentation.
Contributing
Whether you're helping us fix bugs, improve the docs, or spread the word, we'd love to have you as part of the Prismic developer community!
Asking a question: Open a new topic on our community forum explaining what you want to achieve / your question. Our support team will get back to you shortly.
Reporting a bug: Open an issue explaining your application's setup and the bug you're encountering.
Suggesting an improvement: Open an issue explaining your improvement or feature so we can discuss and learn more.
Submitting code changes: For small fixes, feel free to open a pull request with a description of your changes. For large changes, please first open an issue so we can discuss if and how the changes should be implemented.
For more clarity on this project and its structure you can also check out the detailed CONTRIBUTING.md document.
License
Copyright 2013-2025 Prismic <contact@prismic.io> (https://prismic.io)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.Available Tools
5 toolsadd_slice_to_custom_typeA
PURPOSE: Adds a slice to a custom type.
USAGE: Required path for modifying Prismic slice registrations. Adds/registers/attaches a slice to a custom type and regenerates types. Do not edit custom type JSON files manually; this tool performs validation and follow-up steps.
RETURNS: A message indicating whether the slice was added to the type or not, and detailed error messages if it is not.
| Name | Required | Description | Default |
|---|---|---|---|
| sliceMachineConfigAbsolutePath | Yes | Absolute path to 'slicemachine.config.json' file | |
| sliceDirectoryAbsolutePath | Yes | Absolute path to the slice directory (contains 'model.json') | |
| customTypeDirectoryAbsolutePath | Yes | Absolute path to the custom type directory (contains 'index.json') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavior. It states it 'adds/registers/attaches' and 'regenerates types', but lacks details on side effects (e.g., overwrites existing registrations), required permissions, or the validation process. The warning about manual editing is helpful, but overall transparency is minimal for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise (3 lines) and well-structured with 'PURPOSE', 'USAGE', and 'RETURNS' sections. Every sentence adds value; no fluff or repetition. Ideal for quick comprehension.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers purpose, usage, and return values (message/errors). However, it omits prerequisites (e.g., slice and custom type directories must exist, valid model.json) and does not explain the 'regenerates types' effect. For a tool with 3 required params and no output schema, it is adequate but leaves some gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (all 3 parameters have clear descriptions). The description adds no extra detail beyond the schema, so baseline 3 is appropriate. The parameters are self-explanatory from the schema alone.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states 'Adds a slice to a custom type'—a specific verb and resource. It also adds 'regenerates types' to clarify scope. This is direct and unambiguous, distinguishing it from sibling tools which focus on coding, mocking, or modeling slices.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a 'USAGE' section stating it is the 'Required path for modifying Prismic slice registrations' and warns against manual editing. However, it does not explicitly compare to siblings or state when not to use it (e.g., when just modeling a slice). The guidance is present but not comprehensive.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
how_to_code_sliceA
PURPOSE: Provides slice and field implementation guidance for Prismic slice components.
USAGE: Use FIRST when working with any Prismic slice component or field implementation.
RETURNS: Prismic Framework-specific field documentation and code examples.
| Name | Required | Description | Default |
|---|---|---|---|
| sliceMachineConfigAbsolutePath | Yes | Absolute path to 'slicemachine.config.json' file | |
| projectFramework | Yes | Project framework (Next.js, Nuxt, or SvelteKit) | |
| stylingSystem | Yes | Detected styling system in the project (e.g., 'vanilla-css', 'tailwind', 'css-modules', 'styled-components', 'emotion', 'sass'...) | |
| modelAbsolutePath | Yes | Absolute path to the slice's 'model.json' file | |
| fieldsUsed | Yes | Field types used in the slice (from 'prismicio-types.d.ts' file) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It states the tool 'Provides slice and field implementation guidance' and 'RETURNS: ... documentation and code examples', implying a read-only knowledge retrieval. However, it does not explicitly confirm non-destructive behavior or disclose any side effects, which is minimal but acceptable for a guidance tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise: three sentences with clear labels (PURPOSE, USAGE, RETURNS). Every sentence adds value, and the structure is front-loaded. No unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has 5 required parameters and no output schema. The description summarizes the return value as 'Prismic Framework-specific field documentation and code examples', which is somewhat general but sufficient for a guidance tool. It could mention output format or error handling, but overall it covers the essential context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, providing clear descriptions for all 5 parameters. The tool description does not add extra meaning beyond what the schema already conveys, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states it provides slice and field implementation guidance for Prismic slice components, which is a specific verb+resource. It clearly differentiates from sibling tools like 'how_to_mock_slice' (mocking) and 'how_to_model_slice' (modeling).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description says 'Use FIRST when working with any Prismic slice component or field implementation', providing clear context and priority among siblings. It does not explicitly list when not to use or alternatives, but the instruction is direct and helpful.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
how_to_mock_sliceA
PURPOSE: Generate a model-valid slice mock (mocks.json) and provide guidance for text-only refinements.
USAGE: Use when creating or updating slice mocks.
RETURNS: A JSON mock covering all variations, plus guidance for text-only refinements.
| Name | Required | Description | Default |
|---|---|---|---|
| sliceMachineConfigAbsolutePath | Yes | Absolute path to 'slicemachine.config.json' file | |
| sliceDirectoryAbsolutePath | Yes | Absolute path to the slice directory (contains model.json) | |
| userIntent | Yes | User-provided guidance describing desired mock changes, tone, quantities, constraints |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavior. It states it 'generate[s]' a mock and 'provide[s] guidance,' but it doesn't clarify if this is a read-only operation or if it modifies files. It also doesn't mention permissions or side effects. It's adequate but lacks depth.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with three clear sections: PURPOSE, USAGE, RETURNS. Every sentence adds value without repetition. It is front-loaded with the purpose. Slightly more detail could be added without being verbose, so not a perfect 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 3 parameters, no output schema, and no annotations, the description covers the basic purpose but lacks completeness. It doesn't clarify whether the tool reads/writes files, the format of the returned JSON, or how it relates to sibling tools. More detail would be needed for full context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with clear descriptions for each parameter (e.g., absolute paths, user intent). The tool description does not add extra meaning beyond what the schema already provides, but the schema itself is sufficient. Following the baseline rule for high coverage, a score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Generate a model-valid slice mock (mocks.json) and provide guidance for text-only refinements.' The verb 'generate' and resource 'slice mock' are specific. The sibling tools include other how-to tools (code, model), so this tool is distinct as the mocking one.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description says 'Use when creating or updating slice mocks.' This gives a clear context but does not explicitly mention when not to use it or provide alternative sibling tools. No exclusions or comparisons are given, so it's implied but not fully guided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
how_to_model_sliceA
PURPOSE: Provide detailed, opinionated guidance to create or update Prismic slice model files using modern best practices, including naming, file placement, allowed fields, shapes, and configuration.
USAGE: Use FIRST for any Prismic slice creation or modeling request. Do not use for component or mock implementation. Input Type Selection Rules:
If the user attaches an image, include "image".
If the user attaches code, include "code".
Include "text" ONLY if the prompt contains model-related information (e.g., explicitly describes desired fields/structure, adds nuance, or overrides what is seen in the code/image).
It is acceptable to include multiple input types when each adds model-relevant signal per the rules above.
RETURNS: Step-by-step modeling instructions, naming conventions, final Prismic model shapes, comprehensive field shape reference, opinionated modeling guidance, validation and testing steps.
| Name | Required | Description | Default |
|---|---|---|---|
| sliceMachineConfigAbsolutePath | Yes | Absolute path to 'slicemachine.config.json' file | |
| sliceName | Yes | The name of the slice, it MUST be PascalCase, e.g., 'SliceName', cannot start with a number, and with no special characters allowed | |
| isNewSlice | Yes | Whether this is a new slice creation (true) or updating existing slice (false) | |
| contentRequirements | Yes | Description of what content the slice should contain (e.g., 'hero with title, description, and CTA button') | |
| inputTypes | Yes | The kinds of input present in the prompt. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It clearly states it returns step-by-step guidance, naming conventions, shapes, etc. It does not mention side effects, but as a guidance-only tool, that's acceptable. Could be more explicit about not making changes.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Well-structured with sections (PURPOSE, USAGE, Input Type Selection Rules, RETURNS) and bold headings. Concise but informative; each sentence adds value. Could be slightly more streamlined.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description covers purpose, usage, parameter guidance, and return value. It's adequate for an AI agent to select and invoke correctly. Missing only explicit mention that it does not modify anything, but implied.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with good descriptions. The description adds extra meaning: explains input type selection rules, gives an example for contentRequirements, and reinforces the PascalCase pattern for sliceName. This adds significant value beyond schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the purpose: providing opinionated guidance for Prismic slice model files. It specifies the resource (slice model files) and action (create or update), and distinguishes from sibling tools like how_to_code_slice and how_to_mock_slice.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states 'Use FIRST for any Prismic slice creation or modeling request' and 'Do not use for component or mock implementation.' Provides detailed input type selection rules, giving clear context on when to include each input type.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
save_slice_dataB
PURPOSE: Creates or updates a Prismic slice model and/or mocks in your project with given valid data, performing local changes to the slice library.
USAGE: Use to validate and create/update slice data (model and/or mocks).
RETURNS: Success confirmation or detailed validation errors if the data is invalid.
| Name | Required | Description | Default |
|---|---|---|---|
| sliceMachineConfigAbsolutePath | Yes | Absolute path to 'slicemachine.config.json' file | |
| sliceAbsolutePath | Yes | Absolute path to the directory of the slice to be created/updated | |
| data | Yes | The data to be saved for the slice. At least one of 'model' or 'mocks' must be specified. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. States it performs 'local changes' and returns success/errors, but lacks details on overwrite behavior, permissions, or reversibility. Minimal disclosure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, no fluff. Front-loaded with purpose. Concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequately covers purpose and returns, but could be more explicit about the requirement that at least one of model/mocks must be provided (schema notes it, description does not). No output schema, but return description suffices.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with well-described parameters. Description adds 'with given valid data' but little extra beyond schema. Baseline score appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states the verb 'creates or updates' and resource 'Prismic slice model and/or mocks' with scope 'local changes to the slice library'. Does not explicitly differentiate from sibling tools like add_slice_to_custom_type, but purpose is well-defined.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides basic usage guidance: 'Use to validate and create/update slice data'. Does not mention when not to use or alternatives among siblings, but implication is clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
5 tool updates
v0.0.20- First observed
add_slice_to_custom_type - First observed
how_to_code_slice - First observed
how_to_mock_slice - First observed
how_to_model_slice - First observed
save_slice_data
TDQS
Each tool targets a distinct aspect of Prismic slice work: registration, coding guidance, mocking guidance, modeling guidance, and saving model/mock data. No two tools overlap in purpose.
Two naming patterns exist: 'how_to_*' for guidance tools and verb_noun for action tools (add_slice_to_custom_type, save_slice_data). While readable, the mix of patterns reduces consistency.
Five tools is appropriate for a focused server on Prismic slice management, covering key development tasks without being excessive or insufficient.
The tool set covers the main workflows for Prismic slice development: adding to custom types, guidance for coding/mocking/modeling, and saving data. Minor gaps like missing delete or list operations are acceptable given the server's assisting role.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
The official MCP Server for the Mux API
The official MCP Server from Mia-Platform to interact with Mia-Platform Console
- SupabaseOAuthcom.supabase
MCP server for interacting with the Supabase platform
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for interacting with Contentstack's Content Management API15162TypeScriptMIT
- FlicenseNot gradedqualityDmaintenanceA simple demonstration MCP server that provides an echo tool and resource for learning how to build MCP servers. Serves as a starting point and template for creating custom MCP server implementations.1-
- AlicenseNot gradedqualityCmaintenanceDeprecated Python-based PostgreSQL MCP server. Users should migrate to the new TypeScript version with enhanced features.8MIT
- AlicenseNot gradedqualityFmaintenanceThis MCP server provides integration with Make.com (formerly Integromat) for workflow automation. It is now deprecated and replaced by Make's official cloud MCP.1104MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/prismicio/prismic-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server