@capacms/mcp 0.2.0 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 stdio MCP server for Capa. Seventeen reads, two writes, two resources and three
 prompts. People set it up from the
-[AI assistants guide](https://docs.capacms.com/api/ai-assistants), which has
+[AI assistants guide](https://docs.capacms.com/ai/mcp), which has
 the Claude Code, Cursor and Codex config.
 
 It has no dependencies, so `npx` fetches the package and runs it with nothing
@@ -14,7 +14,7 @@ at once and says so.
 With a `cap_` key minted in the Capa admin under **Developers > Keys**:
 
 ```sh
-CAPA_API_URL=https://api.capacms.com CAPA_KEY=cap_live_... npx -y @capacms/mcp
+CAPA_API_URL=https://cdn.capacms.com CAPA_KEY=cap_live_... npx -y @capacms/mcp
 ```
 
 An MCP client starts it the same way: the command is `npx`, the arguments are
@@ -22,7 +22,7 @@ An MCP client starts it the same way: the command is `npx`, the arguments are
 
 | variable | needed | value |
 |---|---|---|
-| `CAPA_API_URL` | always | the API, `https://api.capacms.com` |
+| `CAPA_API_URL` | always | the API, `https://cdn.capacms.com` |
 | `CAPA_KEY` | always | the key the server reads with |
 | `CAPA_TENANT_ID` | a legacy key only: `pk_`, `sk_` or unprefixed | the tenant's id |
 | `CAPA_API_VERSION` | no | the dated `/api/` version, `2026-10-01` |

package/bin/capa-mcp.mjs

@@ -3,7 +3,7 @@
  * capa-mcp — stdio MCP server for Capa. Mostly reads; two tools write.
  *
  * Usage (Claude Code / Codex / any MCP client), on Node 20 or later:
- *   CAPA_API_URL=https://api.capacms.com \   # or CAPA_BASE_URL
+ *   CAPA_API_URL=https://cdn.capacms.com \   # or CAPA_BASE_URL
  *   CAPA_KEY=<tenant api key> \              # or CAPA_API_KEY
  *   CAPA_TENANT_ID=<tenant id> \             # legacy pk_/sk_ keys only
  *   CAPA_API_VERSION=2026-10-01 \            # optional

package/lib/client.mjs

@@ -175,7 +175,7 @@ export function loadConfig(env = process.env) {
         : `  CAPA_TENANT_ID    legacy keys only (pk_, sk_ or unprefixed): the tenant the key belongs to\n`;
     throw new Error(
       `capa-mcp: missing ${missing.join(", ")}.\n` +
-        `  CAPA_API_URL      the API, e.g. https://api.capacms.com (or CAPA_BASE_URL)\n` +
+        `  CAPA_API_URL      the API, e.g. https://cdn.capacms.com (or CAPA_BASE_URL)\n` +
         keyLine +
         tenantLine +
         `  CAPA_API_VERSION  optional; the dated /api/ version, default ${DEFAULT_API_VERSION}`
@@ -184,7 +184,7 @@ export function loadConfig(env = process.env) {
   const route = routeIn(baseUrl);
   if (route) {
     throw new Error(
-      `capa-mcp: CAPA_API_URL is the API's address with no route, e.g. https://api.capacms.com: drop ${route}.\n` +
+      `capa-mcp: CAPA_API_URL is the API's address with no route, e.g. https://cdn.capacms.com: drop ${route}.\n` +
         "  Every tool adds the route it calls (/api/graphql, /api/entries), so a URL ending in one calls it twice.",
     );
   }

package/lib/graphql/served.mjs

@@ -56,7 +56,7 @@ function noApiAt(config, error) {
     `${printable(config.baseUrl)} serves no /api/ route: GET /api/me answered 404 when this server started, and POST /api/graphql answered ${error.status}${error.code ? ` ${error.code}` : ""}. ` +
     "Either CAPA_API_URL is not the Capa API's address, or this deployment does not serve /api/.\n" +
     "Next: tell the person running this server to check that CAPA_API_URL is the API's address with no route after it, " +
-    "e.g. https://api.capacms.com, and restart it; if it is, /api/ is off on this deployment."
+    "e.g. https://cdn.capacms.com, and restart it; if it is, /api/ is off on this deployment."
   );
 }
 

package/lib/server.mjs

@@ -28,7 +28,7 @@ import { instructionsFor } from "./instructions.mjs";
 const PROTOCOL_VERSION = "2025-06-18";
 const SUPPORTED = new Set(["2025-06-18", "2025-03-26", "2024-11-05"]);
 
-export const SERVER_INFO = { name: "capa-mcp", version: "0.2.0" };
+export const SERVER_INFO = { name: "capa-mcp", version: "0.2.1" };
 
 const ok = (id, result) => ({ jsonrpc: "2.0", id, result });
 const fail = (id, code, message) => ({ jsonrpc: "2.0", id, error: { code, message } });

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@capacms/mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "stdio MCP server for Capa, shaped for agents rather than one tool per endpoint.",
   "license": "UNLICENSED",
-  "homepage": "https://docs.capacms.com/api/ai-assistants",
+  "homepage": "https://docs.capacms.com/ai/mcp",
   "type": "module",
   "bin": {
     "capa-mcp": "bin/capa-mcp.mjs"