Skip to main content
Contentstack MCP profile hub is in general availability!

Contentstack stdio MCP

The @contentstack/mcp package runs the Contentstack MCP server on your own machine over stdio. It still works and it is still on npm. For most setups, MCP Profile Hub is the better choice: one hosted URL, OAuth sign-in and only the tools a job needs.

ChatGPT Image Jun 17, 2026, 03_32_00 PM.png

Why Profile Hub is the better choice

Both connect an AI agent to the same Contentstack products. Profile Hub is easier to set up, works in more clients and gives your agent a smaller set of tools that fits the job.

stdio package

MCP Profile Hub

Setup

Runs locally with npx, configured on every machine

Hosted. Add one URL to your client

Clients

Only clients that can start a local process

Also browser clients such as claude.ai and ChatGPT

Tools

Whole tool groups, up to 77 tools for CMA alone

Only the tools in the profile you pick

Sign-in

Session or tokens stored on your machine

OAuth in the browser, with your own Contentstack roles

Switch in a few minutes

  1. Remove the contentstack server that runs npx @contentstack/mcp from your client's MCP config.

  2. Add Profile Hub as a remote MCP server:

    https://mcp-profile-hub.contentstack.com/api/mcp
  3. Sign in, pick your region and choose a profile. Content Explorer is a safe, read-only start.

  4. Ask your agent which Contentstack tools it has to check the connection.

Not sure which profile fits? Pick the right Profile Hub profile for the job. The full setup, with the agent skills, is in Set up your AI workbench.

MCP related writing on our engineering blog

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

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
cttibncdlwrwxeozwqbj.jpg
BLOG

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
mcp-guide.png
GUIDE
Level: Advanced

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...
AI will not live in one place, but trust has to
BLOG

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...

Still need the local package?

Some setups still call for a local server, such as a client that can only start local processes. The package keeps working there. Sign in once and the server saves the session on your machine:

npx @contentstack/mcp --auth

Then add it to your client:

{
  "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>"
      }
    }
  }
}

Load only the groups you need: cma, cma-extended, cda, launch, personalize, brandkit, developerhub, lytics and analytics.