Servidor MCP

postmd-mcp-server

io.github.reinlainer/postmd-mcp-server
Medios y contenido Público y accesible MCP 2025-11-25

Qué hace este MCP

Publishes Markdown documents as shareable web pages and supports retrieving, updating, and deleting published documents.

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).
Esquema de entrada
{'type': 'object', 'required': ['markdown'], 'properties': {'title': {'type': 'string', 'description': 'Shown in the viewer and link previews. Defaults to fileName without .md.'}, 'groupId': {'type': 'number', 'description': 'File the document in this group instead of the default group (needs an API key).'}, 'fileName': {'type': 'string', 'description': 'Upload filename, must end in .md. Default document.md.'}, 'markdown': {'type': 'string', 'description': 'Full Markdown document as one UTF-8 string (the entire source, not a summary). May include graph data in an HTML comment, which the viewer draws; the format is at /docs/graph.'}, 'password': {'type': 'string', 'description': 'Readers must supply this password to see the content.'}, 'viewerStyle': {'type': 'string', 'description': 'Viewer theme: readable (default), github, minimal, report, pamphlet or dark. Unknown values fall back to readable.'}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['docCode'], 'properties': {'docCode': {'type': 'string'}, 'password': {'type': 'string', 'description': 'Document password if the document has one and you are not authenticated as its owner.'}}}
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['docCode'], 'properties': {'docCode': {'type': 'string', 'description': 'Document code, e.g. P-123-456-789.'}}}
postmd_get_document_raw
Get the stored Markdown source of a document. Public — no API key needed. Password-protected documents need `password`.
Solo lectura
Esquema de entrada
{'type': 'object', 'required': ['docCode'], 'properties': {'docCode': {'type': 'string'}, 'password': {'type': 'string', 'description': 'Plain document password, if the document has one.'}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['docCode'], 'properties': {'title': {'type': 'string'}, 'docCode': {'type': 'string'}, 'fileName': {'type': 'string', 'description': 'Upload filename when replacing content. Default document.md.'}, 'markdown': {'type': 'string', 'description': 'Full new Markdown body as one UTF-8 string. Omit if only metadata changes. Adding or revising a graph means sending the whole body with the graph comment in it; the format is at /docs/graph.'}, 'password': {'type': 'string', 'description': 'Readers must supply this password to see the content.'}, 'viewerStyle': {'type': 'string', 'description': 'Viewer theme: readable (default), github, minimal, report, pamphlet or dark. Unknown values fall back to readable.'}, 'clearPassword': {'type': 'boolean', 'description': 'true removes the password.'}, 'notesOnReplace': {'enum': ['keep', 'abort'], 'type': 'string', 'description': 'Required when replacing the content. Notes are located by the text they quote, so replacing the body moves or loses where they point: a note whose quote is gone loses its place in the body, and one whose quote now appears elsewhere points there. keep replaces anyway and leaves the notes. abort refuses when the document has notes anchored to its text, and the answer says how many.'}, 'currentPassword': {'type': 'string', 'description': 'Current password to authenticate if the document is password-protected.'}}}
Modificado
postmd_create_document
1 de October de 2026 a las 02:43
Modificado
postmd_update_document
29 de September de 2026 a las 02:50
Modificado
postmd_create_document
29 de September de 2026 a las 02:50
Modificado
postmd_delete_document
23 de September de 2026 a las 02:41
Modificado
postmd_update_document
23 de September de 2026 a las 02:41
Modificado
postmd_get_document_raw
23 de September de 2026 a las 02:41
Modificado
postmd_get_document
23 de September de 2026 a las 02:41
Modificado
postmd_create_document
23 de September de 2026 a las 02:41
Añadido
postmd_delete_document
21 de September de 2026 a las 02:43
Añadido
postmd_update_document
21 de September de 2026 a las 02:43
Añadido
postmd_get_document_raw
21 de September de 2026 a las 02:43
Añadido
postmd_get_document
21 de September de 2026 a las 02:43
Añadido
postmd_create_document
21 de September de 2026 a las 02:43