mpk_...
Public key
Read-only access for finding and retrieving published content.
Manage your content with AI agents.
Let your AI agent search, create, and manage your publication through one hosted MCP connection.
codex — marble-mcp
>
Find me a post that mentions structured content for AI agents.
—
marble-mcp::search_posts → 1 post found
—
Found one match.
- Title
- Your CMS for AI agents
- Slug
- /cms-for-ai-agents
- Status
- draft
>
Open it and make the first paragraph clearer.
—
marble-mcp::get_post → draft loaded
codex::prepare_edit → diff ready
I tightened the opening and kept the original meaning.
− Your content should be available across many channels.
+ Publish structured content once, then deliver it to every site, app, and AI agent.
The change is ready for your approval. The draft has not been updated yet.
>
Content operations
All your content operations, available to your agent.
Search, create, update, and organize everything in your Marble workspace.
- 6 tools
Posts
Find, read, create, update, and delete posts without leaving your agent.
- 5 tools
Media
Browse assets, upload from a public URL, and keep names and alt text organized.
- 5 tools
Categories
Create and maintain the categories that keep your publication organized.
- 5 tools
Tags
Find, add, update, and remove tags through natural-language workflows.
- 5 tools
Authors
Look up contributors and manage the authors attached to your content.
- 5 tools
Custom fields
Inspect your content model before reading or writing structured field values.
Setup
Connect Marble in one command.
Run the open-source add-mcp CLI, choose your agent, and enter a Marble API key when prompted.
npx add-mcp https://mcp.marblecms.com/mcp --header 'Authorization: Bearer ${MARBLE_API_KEY}' Works with Codex, Claude Code, Cursor, VS Code, and other supported clients. View setup options
Scoped access
The agent only gets the access you give it.
msk_...
Private key
Scoped access for the create, update, upload, and delete tools you approve.
Frequently asked questions
Everything you need to know about connecting AI agents to Marble.
What is Marble's MCP server?
Marble's MCP server is a hosted Model Context Protocol endpoint that gives compatible AI agents tools for working with content in your Marble workspace. Agents can search and read content with a public key, while scoped private keys unlock approved write operations.
Do I need to run or host an MCP server?
No. Marble provides a remote Streamable HTTP server at https://mcp.marblecms.com/mcp. Add the URL and your Marble API key to a compatible client; there is no CMS server package or database for you to operate.
What can an agent do in Marble?
Agents can work with posts, categories, tags, authors, media, and custom fields. Available tools include search and read operations as well as scoped create, update, upload, and delete operations.
Can an agent publish or delete content?
Write and delete tools require a private Marble API key with the necessary scopes. MCP clients can identify destructive tools and ask for confirmation according to the approval settings you choose in that client.
Which AI clients work with Marble MCP?
Marble documents setup for Cursor, Claude Code, Codex, and VS Code. Other MCP clients can connect when they support remote Streamable HTTP servers and custom authentication headers.
Should I use MCP or the REST API?
Use MCP when an AI agent needs to discover and call Marble tools. Use the REST API or TypeScript SDK when you are building a deterministic application integration and want direct control over requests and responses.
Hand your publication to your agent.
Create a workspace, generate the right API key, and connect Marble to the MCP client you already use.