@mapled/mcp 0.9.3 → 0.10.0

package/README.md

@@ -46,6 +46,7 @@ For the first integration, propose one plan and let the owner approve it on a tr
 3. Ask the user to open the returned `reviewUrl` and approve. Poll `get_setup_run` until its status is `approved` (or `rejected` — then propose a better plan).
 4. `apply_setup_plan` — Mapled creates everything in one go and tells you the keys it assigned.
 5. Wire the site: `get_connection`, `configure_revalidation`, deploy, then close with `report_setup` (files changed, `buildPassed`, `secretsCommitted: false`). Mapled runs its own checks — the site reads content, the webhook delivered, the preview route responds, fields have help texts — and the run is completed only when they pass. Fix what failed and call `verify_setup`.
+6. Leave a guide: `get_mapled_md` renders `MAPLED.md` from the project — what the site reads and where, the content model, the working rules, the commands that verify the integration. Write it to the repository root and commit it; the next agent (or person) starts from it. When the file exists, replace everything above its `<!-- mapled:notes -->` line and keep the notes below.
 
 ## Destructive changes
 
@@ -66,5 +67,6 @@ For the first integration, propose one plan and let the owner approve it on a tr
 | `push_site_manifest` / `list_bindings` | Tell Mapled where each field is rendered; read every binding's health (type mismatch, outdated, missing on site). Keep the repository's copy in `mapled/manifest.json` — `npx @mapled/cli scan --write` derives it from the code and `bindings push` / `bindings pull` exchange it with Mapled |
 | `configure_revalidation` | Point the publish webhook at the site, get the signing secret |
 | `check_integration` | The site's integration as Mapled sees it — delivery reads, the webhook and its last delivery, the bindings summary, current package versions; `npx @mapled/cli doctor` shows the same from inside the repository |
+| `get_mapled_md` | `MAPLED.md` rendered from the project — the guide for the next agent: project, how the site reads it, content model, bindings by page, last setup run, working rules, verification commands. Never a secret. `npx @mapled/cli md pull` writes the same file; `mapled doctor` says when it is out of date |
 
 Agents write drafts only — publishing stays with humans in the Mapled app, and nothing changes on the live site until someone presses Publish.

package/dist/tools.js

@@ -149,7 +149,7 @@ export function createTools(api) {
             name: "apply_setup_plan",
             description: "Apply an approved setup plan. Mapled creates the collections, fields and records in one go and returns " +
                 "what was created (keys, counts) plus warnings for records it had to skip. Then wire the site " +
-                "(get_connection, configure_revalidation) and finish with report_setup.",
+                "(get_connection, configure_revalidation), write MAPLED.md (get_mapled_md) and finish with report_setup.",
             schema: { runId: z.string().uuid() },
             handler: async (args) => api.request("POST", `/v1/agent/runs/${encodeURIComponent(args.runId)}/apply`, {}),
         },
@@ -443,6 +443,18 @@ export function createTools(api) {
             },
             handler: async (args) => api.request("PATCH", "/v1/agent/webhook", { url: args.url }),
         },
+        {
+            name: "get_mapled_md",
+            description: "Get MAPLED.md — the guide Mapled writes for the next agent and for people: the project and how the site " +
+                "reads it, the content model, where the site renders each field, the last setup run, the working rules and " +
+                "the verification commands, rendered from the project as it is now. Write `markdown` to MAPLED.md at the " +
+                "repository root and commit it. If the file exists, replace everything above its `<!-- mapled:notes -->` " +
+                "line and keep what is below — that part belongs to the repository. Refresh it after every schema or " +
+                "manifest change and at the end of a setup; `npx @mapled/cli md pull` does the same from the repository " +
+                "and `mapled doctor` says when it is out of date. It never contains a secret — don't add one.",
+            schema: {},
+            handler: async () => api.request("GET", "/v1/agent/mapled-md"),
+        },
         {
             name: "check_integration",
             description: "See the site's integration as Mapled sees it: whether the site has read content with the delivery key " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapled/mcp",
-  "version": "0.9.3",
+  "version": "0.10.0",
   "description": "Mapled MCP server: lets AI agents build schema and content for one Mapled project.",
   "license": "MIT",
   "homepage": "https://mapled.io",