Cmssy MCP server

@cmssy/mcp-server

MCP server for Cmssy CMS — enables AI-driven page creation and management with i18n support.

Setup

Prerequisites

1. Your Cmssy backend API URL (e.g. https://api.your-cmssy.com)
2. An API token (create in Dashboard > API Tokens, starts with cs_)
3. Your workspace ID

Add to Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "cmssy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cmssy/mcp-server",
        "--token",
        "cs_YOUR_TOKEN",
        "--workspace-id",
        "YOUR_WORKSPACE_ID",
        "--api-url",
        "https://api.your-cmssy.com"
      ]
    }
  }
}

Environment Variables

Instead of CLI args, you can set:

• CMSSYAPITOKEN — API token (cs_xxx)
• CMSSYWORKSPACEID — Workspace ID
• CMSSYAPIURL — API URL (required, e.g. https://api.your-cmssy.com)

Response shape (write tools)

As of 0.6.0, most write tools accept an optional response arg:

{id, slug, hasUnpublishedChanges, updatedAt} for page tools, {pageId, blockId, hasUnpublishedChanges, updatedAt} for block tools, {id, slug, status, updatedAt} for form tools, {id, slug, updatedAt} for model tools, {id, status, updatedAt} for record tools, {id, orderNumber, status, paymentStatus, fulfillmentStatus, total, balanceDue, currency, updatedAt} for order tools, {id, code, type, value, enabled, updatedAt} for discount tools.

• response: "minimal" (default) - returns a small ack (~200 bytes):

• response: "full" - returns the full mutation response (pre-0.6 behavior).

Use "full" only if you need the post-write state inline; otherwise issue a follow-up getpage/getform/getmodel/getrecord. This keeps agent context windows from being eaten by echoed content.

Tools that accept response: createpage, updatepageblocks, updatepagesettings, publishpage, unpublishpage, reverttopublished, updatepagelayout, addblocktopage, updateblockcontent, removeblockfrompage, createform, updateform, createmodel, updatemodel, createrecord, updaterecord, createmanualorder, editorder, updateorderdetails, markorderpaid, recordorderpayment, refundorder, cancelorder, transitionorderfulfillment, setorderpipelinestage, recordorderinvoice, creatediscount, updatediscount, setdiscount_enabled.

patchblockcontent and the various delete / status-only tools (updateformsubmissionstatus, import_records) already returned a compact ack and don't take response.

Available Tools

Read Tools

Write Tools

Shortened. The full README is on GitHub.