
Tony Spiro
May 27, 2026

If you've spent any time building with AI agents in the last six months, you've probably seen "MCP" come up in Discord threads, GitHub issues, and Cursor release notes. Search volume for "mcp server" has crossed 60,000 monthly queries and is still climbing. So what exactly is an MCP server, and why is it suddenly everywhere?
This guide answers that question clearly and practically, including how Cosmic's native MCP Server fits into the picture for developers building AI-native applications.
What is an MCP Server?
MCP stands for Model Context Protocol. An MCP server is a lightweight service that exposes tools, resources, and prompts to AI agents in a standardized way.
Think of it like this: your AI agent (Claude, Codex, a custom GPT, etc.) needs to interact with external systems, read files, call APIs, or query databases. Without a standard, every tool integration requires custom glue code. MCP solves that by defining a common interface that any AI client can speak.
At its core, an MCP server:
- Exposes tools that an AI agent can call (e.g., "fetch this content object", "create a new page", "search posts by tag")
- Provides resources that give the agent context (e.g., a knowledge base, a list of available content types)
- Accepts prompt templates that shape how the agent reasons about the data it receives
The protocol was introduced by Anthropic and has since been adopted broadly across the developer ecosystem. It operates over standard transports (HTTP/SSE or stdio), which means any language or framework can implement it.
Why MCP is Surging Right Now
Three things converged in the last 12 months to push MCP from niche spec to mainstream standard.
1. Agentic IDEs need a universal tool layer
Cursor, Claude Code, and Codex are no longer just autocomplete tools. They're full autonomous coding agents that run multi-step tasks: reading files, editing code, running tests, and committing changes. For these agents to act on your data, they need a way to reach it. MCP servers provide exactly that hook.
2. Claude's native MCP support changed the calculus
When Anthropic built MCP support directly into Claude Desktop and the Claude API, adoption exploded. Developers who had been wiring up custom tool definitions switched to MCP because it's portable: build the server once, connect any compatible client.
3. The "skills" model is winning
Early agentic tooling asked developers to describe every tool in a flat JSON schema. MCP introduces the concept of skills: discrete, composable units of capability that agents can discover and invoke dynamically. This is a much better mental model for building production-grade agentic workflows.
What Can You Actually Do With an MCP Server?
MCP servers unlock a specific class of use cases that were previously annoying to build:
Content management via AI agents
An agent can read, create, and update structured content without a human opening a CMS dashboard. Marketing teams can say "publish the Q3 campaign brief as a blog post" in Slack, and an AI agent handles the rest.
Autonomous development workflows
Cursor or Claude Code can pull context from your content model, generate code that correctly maps to your data schema, and push changes, all without leaving the IDE.
Cross-platform content syndication
An agent connected to an MCP server can read a content object from your CMS and push it to multiple distribution channels: Slack, WhatsApp, Telegram, a newsletter API, whatever you wire up.
Dynamic Q&A and search
Give an AI assistant access to your knowledge base via MCP and it can answer questions grounded in real content, with citations, without hallucinating.
Automated content pipelines
Scheduled agents can monitor content status, trigger workflows when objects move from draft to published, or auto-generate metadata like SEO descriptions and alt text.
How Cosmic's MCP Server Works
Cosmic ships a native MCP Server as a first-class feature. This isn't a third-party plugin or a community experiment; it's built and maintained by the Cosmic team.
There are two ways to connect: a hosted endpoint (recommended) and a self-hosted stdio option.
Hosted MCP (Recommended)
The hosted endpoint is the fastest way to connect Cosmic to any AI assistant. No install required:
It supports the streamable-HTTP MCP transport and is ready to use today. Authentication uses your bucket keys in the header:
| Access level | Authorization header |
|---|---|
| Read-only | |
| Full access (read + write) |
Claude Desktop config ( on macOS):
Cursor config ( in your project, or globally):
For read-only access, drop the suffix. Write tools will be blocked with a clear error message; read tools work normally.
Self-Hosted (stdio)
Prefer to run the MCP process inside your dev environment? The npm package ships a stdio-based binary:
Or install globally:
The stdio binary reads credentials from environment variables:
| Variable | Required | Description |
|---|---|---|
| Yes | Your Cosmic bucket slug | |
| Yes | Bucket read key | |
| No | Bucket write key (for write operations) |
Claude Desktop (self-hosted):
The 18 Tools Cosmic's MCP Server Exposes
Once connected, your AI assistant has access to 18 tools across four categories:
Objects (5 tools)
- — list or search content objects by type, status, or locale
- — fetch a single object by ID or slug
- — create a new object (blog post, page, product, etc.)
- — edit an existing object's content or metadata
- — permanently delete an object
Media (4 tools)
- — browse media files, optionally scoped to a folder
- — fetch metadata and the imgix URL for a single asset
- — upload a file from a URL or base64 payload
- — remove a media file
Object Types (5 tools)
- — list every content model in the bucket
- — fetch the full schema for a single type
- — define a new content model
- — evolve an existing schema
- — drop a content model (and all its objects)
AI Generation (4 tools)
- — draft, rewrite, summarize, or translate copy using your bucket's own content as context
- — generate an image and store it in your media library
- — generate a short video clip (Google Veo)
- — generate narration audio from text (13 voices via OpenAI TTS)
MCP Server vs. Agent Skills: What's the Difference?
These two features are complementary but serve different purposes:
| Feature | MCP Server | Agent Skills |
|---|---|---|
| Purpose | Direct content management | Code generation guidance |
| Use case | "List my blog posts" | "Build a blog with Cosmic" |
| How it works | AI calls tools to interact with your bucket | AI writes code using the SDK |
| Best for | Managing content while developing | Building applications |
Use both together for the best experience: Agent Skills helps your AI write application code that uses the Cosmic SDK; MCP Server lets your AI directly manage content in your bucket.
Getting Started with Cosmic's MCP Server
Step 1: Create a free Cosmic account
Sign up at cosmicjs.com (no credit card required). You get a free bucket with 1,000 objects and full MCP access.
Step 2: Get your credentials
In your Cosmic dashboard, navigate to your bucket, then go to Settings > API Access. Copy your bucket slug, read key, and write key.
Step 3: Connect your MCP client
Add the hosted endpoint to your Claude Desktop or Cursor config (see the JSON snippets above). For Cursor, drop the config in at the project root.
Step 4: Start issuing natural-language commands
Once connected, your agent can act on your content model:
- "List all draft blog posts from the last 7 days"
- "Create a new landing page object with this headline and copy"
- "Update the SEO description for the homepage object"
- "Find all published posts tagged 'AI' and summarize them"
- "Generate an image of a futuristic city skyline and upload it to my media library"
No custom tool definitions required. The 18 tools are already there.
TypeScript SDK
Cosmic's TypeScript SDK () gives you a fully typed interface for every API operation. The same SDK your MCP server uses is the one you'd use in any Next.js, Nuxt, Astro, or Remix project:
AI Agents That Live in Your Communication Stack
Cosmic's team agents connect directly to Slack, WhatsApp, and Telegram. This means your content workflows can be triggered conversationally, not just via code. A product manager can message an agent in Slack, the agent calls MCP tools to fetch and update CMS content, and the response comes back in the same thread.
Why Cosmic for MCP-Powered Workflows?
There are a few headless CMS options out there, but Cosmic is purpose-built for the AI-native era:
- Hosted MCP endpoint: connect any client in under 5 minutes, no install required
- 18 built-in tools across objects, media, schemas, and AI generation
- REST API with sub-100ms response times: agents stay fast
- TypeScript SDK with full type safety
- Team agents that live in Slack, WhatsApp, and Telegram
- Flexible content modeling: any schema, any type, any relationship
- Free tier includes full MCP access: 1 bucket, 1,000 objects, no credit card
Pricing starts at $0/month for the Free plan and scales to $49/month (Builder), $299/month (Team), and $499/month (Business). Additional team members are $29/user/month.
Start Building Today
MCP is moving fast, and the developers who wire up production-grade MCP workflows now will have a meaningful head start. Cosmic's hosted MCP endpoint removes the infrastructure work and lets you focus on what the agent actually does.
Sign up free, no credit card required →
Want a walkthrough of Cosmic's MCP setup for your specific stack? Book a quick intro with Tony →
Or dive straight into the docs: cosmicjs.com/docs/mcp-server →
Cosmic is a YC W19-backed headless CMS built for developers and AI-native teams. Questions? Find us on Discord.
Continue Learning
Ready to get started?
Build your next project with Cosmic and start creating content faster.
No credit card required • Free forever



