Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "postmd-mcp-server": {
      "type": "http",
      "url": "https://postmd.turink.com/mcp"
    }
  }
}

claude mcp add --transport http postmd-mcp-server https://postmd.turink.com/mcp

[mcp_servers.postmd-mcp-server]
url = "https://postmd.turink.com/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "postmd-mcp-server": {
      "type": "remote",
      "url": "https://postmd.turink.com/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "postmd-mcp-server": {
      "type": "http",
      "url": "https://postmd.turink.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=postmd-mcp-server&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcG9zdG1kLnR1cmluay5jb20vbWNwIn0%3D"
}

{
  "servers": {
    "postmd-mcp-server": {
      "type": "http",
      "url": "https://postmd.turink.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "postmd-mcp-server": {
      "httpUrl": "https://postmd.turink.com/mcp"
    }
  }
}

extensions:
  "postmd-mcp-server":
    enabled: true
    name: "postmd-mcp-server"
    type: streamable_http
    uri: "https://postmd.turink.com/mcp"
    timeout: 300

Quality 85 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations5 of 5 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: postmd_delete_document (readOnlyHint, idempotentHint, openWorldHint); postmd_create_document (readOnlyHint, idempotentHint, openWorldHint); postmd_update_document (readOnlyHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 1,139 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changes4 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected]

5 tools, about 1,139 tokens to load them all · tool set 2381183cce73 · tools last changed 2026-10-04 · checked 2026-10-19 20:06 UTC

Tool changes

2026-10-04postmd_create_documentchangeddescription
before
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).
after · 79% of words in common
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.
2026-09-29postmd_create_documentchangedinput schema
2026-09-28postmd_update_documentchangedinput schema
2026-09-28postmd_create_documentchangedinput schema

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance80

liveness100

freshness100

hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% +updated-16d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://postmd.turink.com/mcp` streamable-http	none	yes	100%	1337 ms	2025-11-25	2026-10-19

package	registry	version	runtime	secrets
`postmd-mcp-server`	npm	2.6.1	–	`POSTMD_API_KEY`

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_delete_document`destructive	Delete a document. Password-protected documents require the password or the owner's API key; documents without a password can be deleted by anyone.
`postmd_get_document`read-only	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`read-only	Get the stored Markdown source of a document. Public — no API key needed. Password-protected documents need `password`.
`postmd_update_document`destructive	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.reinlainer/postmd-mcp-server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://postmd.turink.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "2.6.1",
  "packages": [
    {
      "version": "2.6.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "postmd-mcp-server",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "POSTMD_BASE_URL",
          "description": "Where PostMD runs. Defaults to https://postmd.turink.com; set it only for a self-hosted instance."
        },
        {
          "name": "POSTMD_API_KEY",
          "isSecret": true,
          "description": "Needed only for managing documents and groups. Publishing and reading work without it."
        },
        {
          "name": "POSTMD_DEBUG",
          "description": "Set to 1 for verbose diagnostics on stderr."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/reinlainer/postmd-mcp-server",
    "source": "github"
  },
  "description": "Publish Markdown as a shareable web page, with document graphs"
}