How to Use the Prismic MCP in VS Code Copilot

Q: How do we set up the Prismic MCP Server for our entire team in VS Code Copilot?

Create a .vscode/mcp.json file at the root of your repository and commit it to your git history. When your team opens the project in VS Code 1.96+, Copilot will automatically load the Prismic tools.

Q: Can VS Code Copilot help me debug a broken Prismic query?

Yes. Ask the agent to inspect the query schema using getqueryformschema or run a test query with queryprismicdocuments to see the exact validation errors and payload structure.

Q: Does VS Code Copilot support querying Prismic documents by custom type?

Yes. The agent uses listdocumentsbytype to find all documents belonging to a custom type, allowing you to quickly verify schemas and content structures across multiple files.

Share Prismic content tools across your engineering team directly within VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Prismic MCP to VS Code Copilot

Create your Vinkius account to connect Prismic to VS Code Copilot — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Prismic with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Shared team workflows with the Prismic MCP Server

Commit your Prismic CMS configuration to Git so the whole team has the same tools inside VS Code Copilot. By adding this MCP Server to your `.vscode/mcp.json` file, every developer on your team can query Prismic schemas without setting up custom API clients. Your team can use VS Code Copilot to run `get_repo_metadata` to verify that everyone is coding against the correct Prismic master ref. This stops the classic issue where developers write code against outdated content models that don't match the production Prismic API.

Draft and verify content queries inside VS Code Copilot

Stop switching between your editor and the Prismic API browser when writing queries in VS Code Copilot. VS Code Copilot uses `query_prismic_documents` to test raw queries, letting you see exactly what the Prismic API returns before committing your data fetching logic. If a specific Prismic document is causing a rendering error in your local dev server, the VS Code Copilot agent runs `get_document_by_id` to inspect the raw JSON. You can spot missing Prismic fields or malformed content blocks right next to your code in VS Code Copilot.

Audit tags and locales across your workspace

Keep your internationalized sites running smoothly by analyzing localizations directly within VS Code Copilot. The VS Code Copilot agent calls `list_i18n_languages` to pull the active locales and uses `search_filtered_locale` to check how Prismic content renders across different languages. For content audits, the VS Code Copilot agent runs `list_documents_by_tag` or `list_global_tags` to generate lists of active Prismic pages. This makes it easy to find and fix broken links or outdated Prismic tags before they hit production.

Setup guide

Set up Prismic MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Prismic MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Prismic tools listed. Try asking: "List my recent Prismic transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "prismic-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Prismic. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Prismic now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Prismic MCP in VS Code Copilot

Create a `.vscode/mcp.json` file at the root of your repository and commit it to your git history. When your team opens the project in VS Code 1.96+, Copilot will automatically load the Prismic tools.

Yes. Ask the agent to inspect the query schema using `get_query_form_schema` or run a test query with `query_prismic_documents` to see the exact validation errors and payload structure.

Simply ask the Copilot agent to retrieve the document. It will invoke `get_document_by_id` and output the raw JSON directly in the chat panel for easy inspection.

Yes. The agent uses `list_documents_by_type` to find all documents belonging to a custom type, allowing you to quickly verify schemas and content structures across multiple files.

The MCP server operates inside an isolated, zero-trust sandbox managed by Vinkius. Your Prismic API keys and content payloads are encrypted in transit and processed in memory, never written to persistent logs.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript