# postmd-mcp-server

MCP server for PostMD — publish Markdown as a shareable web page, with document graphs

- **Type:** MCP server
- **Trust:** 85/100 (A), scored on the package rubric
- **Verification:** verified (build provenance)
- **Version:** 2.6.0
- **Author:** io.github.reinlainer
- **License:** MIT
- **npm:** postmd-mcp-server
- **Endpoints:** streamable-http https://postmd.turink.com/mcp
- **Source:** https://github.com/reinlainer/postmd-mcp-server
- **Endpoint health:** reachable (last checked 2026-09-25T13:43:03.054Z, 2 samples) — uptime is not a security property and is not part of the trust score
- **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport)

## Trust

85/100 (A), scored on the package rubric
- Publisher verified: no
- Build provenance: verified attestation
- npm trusted publishing (OIDC): yes
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 3 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-10-03T22:52:50.792Z
- **Version scanned:** 2.6.0
- **CVEs:** none found by OSV at scan time

## Tools

20 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `postmd_create_document` — Publish Markdown as a PostMD web page. No API key required — anyone can publish.
- `postmd_create_document_from_file` — Same as postmd_create_document, but reads the Markdown from filePath on the machine
- `postmd_create_documents_from_files` — Publish several .md files in one call (bulk upload). Requires an API key with
- `postmd_get_document` — Get document metadata by docCode: title, fileName, hasPassword,
- `postmd_get_document_raw` — Get the stored Markdown source of a document. Public — no API key needed.
- `postmd_update_document` — Update a document. Password-protected documents require the password or the owner's API key;
- `postmd_update_document_from_file` — Same as postmd_update_document, but reads the new Markdown from filePath on the
- `postmd_delete_document` — Delete a document. Password-protected documents require the password or the owner's API key;
- `postmd_list_notes` — List notes and highlights on a document: your own plus every SHARED one, newest
- `postmd_add_note` — Attach a note or highlight to a document. Requires an API key with documents:write.
- `postmd_update_note` — Edit a note you wrote. Requires an API key with documents:write. Omitting scope
- `postmd_resolve_note` — Mark a note as settled, or undo it with resolved=false. Meaningful on SHARED
- `postmd_delete_note` — Delete a note: your own, or a SHARED note on a document you own. Requires an API
- `postmd_list_my_notes` — List every note the key's member wrote, across all documents, with docCode and
- `postmd_list_groups` — List groups the key's member belongs to. Requires an API key with groups:read. Paged.
- `postmd_list_group_documents` — List documents in a group. Requires an API key with groups:read and documents:read.
- `postmd_move_document_to_group` — Move a document you own into a group. A document belongs to exactly one group, so this
- `postmd_create_group` — Create a group. Requires an API key with groups:write. Documents can then be filed into it.
- `postmd_update_group` — Rename a group. Owner only. Requires an API key with groups:write.
- `postmd_delete_group` — Delete a group. Owner only; the default group cannot be deleted. Documents in it

## Install

**Verdict: install** — No blocking findings and no open coverage gaps — safe to install as configured.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"postmd-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"postmd-mcp-server\"\n      ],\n      \"env\": {\n        \"POSTMD_API_KEY\": \"<YOUR_POSTMD_API_KEY>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `POSTMD_API_KEY` — Postmd API Key (optional)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 1 credential (0 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Extensive blast radius — deletes data; runs locally and hosted.
- Floor 59, ceiling 59 (tier: extensive)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/postmd-mcp-server
- Install plan: https://forgeregistry.com/api/v1/packages/postmd-mcp-server/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/postmd-mcp-server
- HTML page: https://forgeregistry.com/registry/postmd-mcp-server
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.