How do I connect my ButterCMS data to my AI?

You subscribe to the MCP on Vinkius and provide your ButterCMS API Token. Once connected, your AI client can immediately start querying your content.

Which AI clients can use this MCP?

This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.

Do I need to write code to search my blog posts?

No. You can use natural language to ask your agent to search, list, or retrieve specific posts and collections.

Can I use this to debug my headless site structure?

Yes. You can use capabilities like get_page_layout to inspect the exact structural data and JSON outputs of your custom pages.

Is my API token secure?

Vinkius manages your credentials and hosts the MCP, ensuring your connection to ButterCMS remains secure and functional.

Can my AI analyze the full content of an already published article?

Absolutely. Through the generic get_post_details capability using a targeted URL slug, the agent actively retrieves the article content boundaries directly from ButterCMS, letting you check formatting errors inside the markup natively.

Does it connect out to our Custom Pages or specifically built Collections?

Yes. Beyond just basic blog articles, the agent explores specific array bounds pulling the 'list_custom_pages' endpoint isolating pure localized architectures and fields.

Will it discover writers or tags independently mapping cross-relations?

Yes! Running standard category lists returns an exact enumeration mapping taxonomy arrays straight into conversational strings. Ask the bot 'Who are our CMS authors?' and watch the results.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect ButterCMS to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Let your AI agent navigate and query your entire content warehouse.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 10 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through ButterCMS.

01
Get page layout
This capability retrieves the exact structural data for UI routing verification.
02
Get post details
Use this to pull specific article data using a post slug.
03
List butter authors
Use this to run validation checks on your registered CMS writers.
04
List butter categories
This capability lets you analyze your CMS grouping and category structures.

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through ButterCMS.

05
List global collections
Enumerate the structured rules and items attached to your global collections.
06
List custom pages
This capability inspects deep internal arrays for specific page configurations.
07
List blog posts
This capability identifies the available routing spaces within your ButterCMS post limits.

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through ButterCMS.

08
Search blog posts
Perform full-text searches to extract properties tied to specific keywords.
09
Search collection field
Identify specific arrays across your filtered collections.
10
List butter tags
Access your global taxonomy and tag mappings through this capability.

Real work

What teams actually run

SEO Gap Analysis

Search for specific keywords to see if your content library already covers them.

CMS Debugging

Verify that custom page layouts are returning the correct structured data.

Taxonomy Cleanup

Review all tags and categories to ensure your content organization is consistent.

Author Audits

Quickly list and validate all writers within your publishing system.

Automate a task

Put ButterCMS to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

ButterCMS works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put ButterCMS to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

890ms average. Fast in production.

ButterCMS is checked daily against the live service.

Daily averagePeak 1163ms

Oct 3Today

Fastest day: 732ms
Slowest day: 1163ms
14-day trend: Slowing+28%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of ButterCMS, so you can see the experience inside your AI.

It does not authenticate your account with ButterCMS. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

ButterCMS Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — ButterCMS capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "buttercms-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lz8oJACuel9Orm3eZ03PsVsPvz38Hxfltpy66t6c/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up ButterCMS in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work ButterCMS owners hand off.

This MCP is built for professionals managing headless content architectures who need to bridge the gap between their CMS and their AI capabilities.

01
SEO and Marketing Teams
They use the agent to evaluate tag structures and find existing articles for backlinking.
02
Headless Engineers
They use the agent to debug component structures and verify JSON outputs for custom pages.
03
Content Writers
They use the agent to scan the knowledge base for existing coverage of target keywords.

FAQ

Questions ButterCMS owners ask.

01
How do I connect my ButterCMS data to my AI?
You subscribe to the MCP on Vinkius and provide your ButterCMS API Token. Once connected, your AI client can immediately start querying your content.
02
Which AI clients can use this MCP?
This MCP works with any compatible client, including Claude, Cursor, Windsurf, and VS Code.
03
Do I need to write code to search my blog posts?
No. You can use natural language to ask your agent to search, list, or retrieve specific posts and collections.
04
Can I use this to debug my headless site structure?
Yes. You can use capabilities like get_page_layout to inspect the exact structural data and JSON outputs of your custom pages.
05
Is my API token secure?
Vinkius manages your credentials and hosts the MCP, ensuring your connection to ButterCMS remains secure and functional.
06
Can my AI analyze the full content of an already published article?
Absolutely. Through the generic get_post_details capability using a targeted URL slug, the agent actively retrieves the article content boundaries directly from ButterCMS, letting you check formatting errors inside the markup natively.
07
Does it connect out to our Custom Pages or specifically built Collections?
Yes. Beyond just basic blog articles, the agent explores specific array bounds pulling the 'list_custom_pages' endpoint isolating pure localized architectures and fields.
08
Will it discover writers or tags independently mapping cross-relations?
Yes! Running standard category lists returns an exact enumeration mapping taxonomy arrays straight into conversational strings. Ask the bot 'Who are our CMS authors?' and watch the results.

Explore

More in Developer Tools

Connect ButterCMS to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get page layout

Get post details

List butter authors

List butter categories

05-07

List global collections

List custom pages

List blog posts

08-10

Search blog posts

Search collection field

List butter tags

What teams actually run

SEO Gap Analysis

CMS Debugging

Taxonomy Cleanup

Author Audits

Building your own app? The connector is yours to use.

ButterCMS Connector

Claude Desktop

SEO and Marketing Teams

Headless Engineers

Content Writers

How do I connect my ButterCMS data to my AI?

Which AI clients can use this MCP?

Do I need to write code to search my blog posts?

Can I use this to debug my headless site structure?

Is my API token secure?

Can my AI analyze the full content of an already published article?

Does it connect out to our Custom Pages or specifically built Collections?

Will it discover writers or tags independently mapping cross-relations?

Kontent.ai (Enterprise Headless CMS) AI Connector

Import.io (Web Data Extraction) AI Connector

Cosmic (Headless CMS & Content API) AI Connector

Hevo Data (ETL & Data Pipeline) AI Connector

Suggestions

Data Pipeline Prover AI Connector

Data.gov Catalog AI Connector

data.world AI Connector

Magnolia (Enterprise Headless CMS) AI Connector