io.github.reinlainer/postmd-mcp-server

postmd-mcp-server

Publish Markdown as a shareable web page, with document graphs

2.6.1
Version
remote + npm
Transport
5
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 5 tools scanned
  • metadata: scanned
  • packages: 1 checked

No findings.

Tools (5)

  • postmd_create_document

    Publish Markdown as a PostMD web page. No API key required — anyone can publish. Returns docCode and data.shareUrl; hand shareUrl to people. Documents have a 30-day retention period (data.retainedUntil) that extends on each read. Documents without a password can be updated or deleted by anyone; password-protected documents require the password or the owner's API key. With an API key the document belongs to that member; groupId files it into that group (key with documents:write). The returned docCode can be kept at the top of the source file in a `postmd:document` comment (format at /docs/api) so a later session finds the document.

  • postmd_get_document

    Get document metadata by docCode: title, fileName, hasPassword, viewerStyle, timestamps. Public — no API key needed. Content is not included; use postmd_get_document_raw for the Markdown source.

  • postmd_get_document_raw

    Get the stored Markdown source of a document. Public — no API key needed. Password-protected documents need `password`.

  • postmd_update_document

    Update a document. Password-protected documents require the password or the owner's API key; documents without a password can be updated by anyone. Include `markdown` to replace the stored content; any metadata field replaces that field. clearPassword removes the password. Replacing the content requires notesOnReplace.

  • postmd_delete_document

    Delete a document. Password-protected documents require the password or the owner's API key; documents without a password can be deleted by anyone.