MDShare Agent

---

name: mdshare-agent

description: Create, read, unlock, update, and delete temporary Markdown shares through the MDShare service. Use when an agent needs to publish Markdown as a short-lived share link, fetch shared Markdown, access password-protected or burn-after-read content, continue editing with a manage or edit token, or hand back public/edit/manage links for collaboration. Triggers include “share this markdown”, “generate a temporary link”, “publish notes”, “read an MDShare link”, “update an existing share”, and “delete a temporary share”.

---

# MDShare Agent

Use MDShare as a lightweight anonymous Markdown publishing backend.

Service

- Public link: `/s/{slug}`

- Edit/manage page: `/e/{slug}#edit={token}` or `/e/{slug}#manage={token}`

Core Workflows

Create a share

Send `POST /api/shares` with JSON:

{
  "markdownContent": "# Title\n\nBody",
  "expiresInHours": 24,
  "password": "",
  "burnMode": "OFF",
  "editableMode": "READ_ONLY"
}

Rules:

- `OFF`

- `AFTER_FIRST_VIEW_GRACE`

- `AFTER_FIRST_VIEW_INSTANT`

- `READ_ONLY`

- `EDIT_LINK`

Return these links to the user:

Example using the default deployment:

Read a public share

Call `GET /api/shares/{slug}/public`.

Possible states:

If the state is `gated`, ask for the password only when needed and explain burn-after-read before confirming access.

Unlock a gated share

Send `POST /api/shares/{slug}/public` with JSON:

{
  "password": "optional-password",
  "confirmView": true
}

Use `confirmView: true` when the service says burn confirmation is required.

Read or edit through a token

Use header:

x-share-token: <token>

Call `GET /api/shares/{slug}/manage` to inspect the current share and role.

Save content

Send `PATCH /api/shares/{slug}/manage` with header `x-share-token` and JSON:

{
  "markdownContent": "# Updated\n\nContent",
  "lastKnownUpdatedAt": "2026-03-12T00:00:00.000Z",
  "force": false
}

If the API returns `409` with `conflict: true`, do not overwrite silently. Summarize the conflict and ask whether to force-save.

Update settings

Owner token only. Send `PATCH /api/shares/{slug}/settings` with JSON:

{
  "expiresInHours": 168,
  "password": "",
  "burnMode": "OFF",
  "editableMode": "READ_ONLY"
}

If the response includes a new `editorToken`, regenerate the edit link.

Delete a share

Owner token only. Call `DELETE /api/shares/{slug}/manage` with `x-share-token`.

Behavior Guidance

- `expiresInHours: 168`

- `burnMode: OFF`

- `editableMode: READ_ONLY`

Reference