Skip to main content
Our docs redesign is live!
ChatGPT Image Jun 17, 2026, 03_32_00 PM.png

What the Contentstack MCP does

The Contentstack MCP Server bridges your Contentstack stack and related services, the Content Management API, Content Delivery API, Analytics, Launch, BrandKit, Personalize, Developer Hub, and Lytics to any MCP-compatible AI agent.

Once configured, your AI agent can:

  • Read, create, update, publish, and unpublish entries and assets in plain language
  • Inspect audit logs, version history, and workflow stages
  • Trigger deployments, check logs, and revalidate CDN caches in Launch
  • Generate on-brand content via BrandKit AI using voice profiles and a knowledge vault
  • Query audience segments, user profiles, and A/B test results in Personalize and Lytics
  • Manage Marketplace apps and OAuth settings in Developer Hub
  • Pull API usage, cache hit rates, and SDK adoption metrics from Analytics

Who it's for

  • Developers building AI-powered content workflows or automations
  • Content architects who want an agent to help audit, model, or migrate content
  • DevRel and solutions engineers demonstrating Contentstack capabilities with AI
  • AI workflow builders connecting Contentstack to agent frameworks and pipelines

Authenticate with OAuth

Authenticate once with OAuth and the server saves your session locally, no token juggling, no re-login until it expires. Pick your region and organization in the browser, grant access, and your agent is live against your stack.

The server reuses your saved session automatically on every run.

npx @contentstack/mcp --auth

Drop it into your client

Any MCP client that speaks stdio works: Claude Desktop, Cursor, Claude Code, and more.

{
  "mcpServers": {
    "contentstack": {
      "command": "npx",
      "args": ["-y", "@contentstack/mcp"],
      "env": {
        "CONTENTSTACK_API_KEY": "<your_stack_api_key>",
        "CONTENTSTACK_DELIVERY_TOKEN": "<your_delivery_token>",
        "GROUPS": "<comma_separated_groups>"
      }
    }
  }
}

Loading only the groups you need keeps tool definitions lean and your agent focused.

MCP related writing on our engineering blog

ai-generated-build-context-aware-mcps-not-api-wrappers-1770908929372.png

Build context-aware MCPs, not API wrappers

Discover why simply wrapping APIs isn't enough for Model Context Protocol (MCP) servers. Learn how adding project and user context can transform MCPs into dynamic, efficient engines that enhance AI reasoning, reduce errors, and scale across complex environments.

aiapimcp
BLOG
cttibncdlwrwxeozwqbj.jpg

MCP fragmentation, context efficiency, and the rise of curated skills

This article explores the fragmentation of the Model Context Protocol (MCP) in the AI ecosystem, highlighting challenges with context window efficiency, the complexity developers face, and emerging solutions like curated tool subsets and Claude Skills. It offers insights into protocol-layer issues, strategies for improving reliability, and the pragmatic necessity for adaptable system architectures amid ongoing standards wars.

aiautomationopinion
BLOG
mcp-guide.png

How to build your own MCP server with Contentstack's tools API

Learn how to build a custom MCP server using Contentstack Tools API: fetch tool definitions, register MCP tools, proxy calls to REST/GraphQL, and add controls.

mcpapiai...
GUIDE
AI will not live in one place, but trust has to

AI will not live in one place, but trust has to

This article discusses the tension between rapidly expanding enterprise AI capabilities and the need for strong governance, introducing a two-layer architecture: off-platform AI for experimental reach and on-platform AI for trusted, governed execution. It explains how combining both layers allows organizations to benefit from flexible, distributed AI while maintaining oversight, brand integrity, and risk management.

aimcpagent skills...
BLOG

Nine groups, load what you need

Every group is a focused toolset. Enable one, several, or all.

Group

Tools

What it does

cma

77

Entries, assets, content types, branches, releases, publishing, variants, environments, global fields, taxonomies

cma-extended

22

Audit logs, version history, global field writes, asset folders, workflow & publish-rule inspection

cda

4

Fast, read-only published content via CDN

launch

27

Projects, deployments, deploy hooks, logs, uploads, CDN cache revalidation

personalize

24

Attributes, audiences, experiences, events, analytics

brandkit

12

AI content generation, voice profiles, knowledge vault

developerhub

12

Marketplace app lifecycle, OAuth settings, installations

lytics

10

Audiences, profiles, content topics, classification

analytics

8

API/CDN usage, cache performance, SDK adoption