feat: bundle the Contentstack MCP Profile Hub server with every plugin

.claude-plugin/plugin.json

@@ -6,5 +6,9 @@
   "homepage": "https://developers.contentstack.com",
   "repository": "https://github.com/contentstack/contentstack-agent-skills",
   "license": "MIT",
+  "documentationUrl": "https://www.contentstack.com/docs/developers/mcp-profile-hub",
+  "supportUrl": "https://www.contentstack.com/support",
+  "privacyPolicyUrl": "https://www.contentstack.com/legal/privacy",
+  "termsOfServiceUrl": "https://www.contentstack.com/legal/terms-of-service",
   "keywords": ["contentstack", "cms", "headless-cms", "delivery-sdk", "live-preview", "studio", "launch"]
 }

.cursor-plugin/plugin.json

@@ -3,5 +3,8 @@
   "version": "0.3.1",
   "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations.",
   "author": { "name": "Contentstack", "url": "https://www.contentstack.com" },
-  "skills": "./skills/"
+  "skills": "./skills/",
+  "mcpServers": {
+    "contentstack": { "url": "https://mcp-profile-hub.contentstack.com/api/mcp" }
+  }
 }

.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "contentstack": {
+      "type": "http",
+      "url": "https://mcp-profile-hub.contentstack.com/api/mcp"
+    }
+  }
+}

CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to the Contentstack agent skills bundle. Versions match the
 
 ## 0.3.1
 
+### Contentstack MCP server bundled with the plugin
+
+- Every plugin now connects the hosted Contentstack MCP Profile Hub (`https://mcp-profile-hub.contentstack.com/api/mcp`), so the skills and the Contentstack tools install together. Sign-in is OAuth in the browser on first use, with no API key.
+  - Claude Code and claude.ai: `.mcp.json` (`type: http`).
+  - Codex, ChatGPT and other Agent Plugins clients: `mcp.json` (`type: streamable-http`).
+  - Cursor: `mcpServers` in `.cursor-plugin/plugin.json`, which Cursor reads in place of `mcp.json`.
+  - Gemini CLI: `mcpServers` in `gemini-extension.json` (`httpUrl`).
+- Existing installs get the server on their next update and are asked to sign in the first time a Contentstack tool runs.
+
 ### New studio guides
 
 - **`csr-and-ssr-requirements`:** what a Studio page needs as CSR or SSR on the visitor site, the Live Preview pane, Visual Editor and the canvas.

README.md

@@ -60,6 +60,12 @@ npx skills add contentstack/contentstack-agent-skills --skill cms-entries --skil
 
 Use `--list` to see every skill, or leave out `--skill` to install them all. The CLI installs into the right folder for Claude Code, Cursor, Codex, Copilot, Gemini, Windsurf, Cline and others.
 
+## Contentstack MCP server
+
+Every plugin manifest here also connects the hosted [Contentstack MCP Profile Hub](https://www.contentstack.com/docs/developers/mcp-profile-hub) at `https://mcp-profile-hub.contentstack.com/api/mcp`, so installing the plugin gives the agent the skills and the Contentstack tools together. The server signs you in with OAuth in the browser the first time a tool is used: there is no API key to configure, and every call runs with your own Contentstack roles. At sign-in you pick your region, a profile and a stack.
+
+If you only want the skills, disable the `contentstack` MCP server in your tool's MCP settings after installing.
+
 ## Skills included
 
 | Slug | Title | Product | What it helps with |
@@ -101,7 +107,9 @@ skills/<slug>/SKILL.md            Source of truth: one folder per skill
 .cursor-plugin/                   Cursor plugin and marketplace
 .agents/plugins/marketplace.json  Codex marketplace
 plugin.json                       Agent Plugins manifest (Codex, VS Code)
-gemini-extension.json             Gemini CLI extension
+mcp.json                          MCP server for Agent Plugins (Codex, ChatGPT)
+.mcp.json                         MCP server for Claude Code and claude.ai
+gemini-extension.json             Gemini CLI extension (skills and MCP server)
 docs/                             Documentation: install, architecture, contributing, skill reference
 scripts/validate.mjs              Validates skills and manifests (runs in CI)
 ```

gemini-extension.json

@@ -1,5 +1,10 @@
 {
   "name": "contentstack-skills",
   "version": "0.3.1",
-  "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations."
+  "description": "Contentstack agent skills for CMS modeling, Delivery SDK, Live Preview, Studio, Brand Kit, Developer Hub apps, Launch, and migrations.",
+  "mcpServers": {
+    "contentstack": {
+      "httpUrl": "https://mcp-profile-hub.contentstack.com/api/mcp"
+    }
+  }
 }

mcp.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "contentstack": {
+      "type": "streamable-http",
+      "url": "https://mcp-profile-hub.contentstack.com/api/mcp"
+    }
+  }
+}