INDIVIDUAL MCP TOOL

get_appearance

Use this when you need the color swatches for specific themes chosen from list_appearance (or guessed).

pst.mdnone authenticationAvailability not checked

LIVE ENDPOINT

https://pst.md/api/mcp

No auth detected

Connect to this endpoint to inspect the live schema for get_appearance and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.pst-md]
url = "https://pst.md/api/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "pst-md": {
      "type": "http",
      "url": "https://pst.md/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: pst-md
Remote MCP URL: https://pst.md/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "pst-md": {
      "url": "https://pst.md/api/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "pst-md": {
      "type": "http",
      "url": "https://pst.md/api/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "pst-md",
  "transport": "streamable-http",
  "url": "https://pst.md/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

list_appearance — Use this when you need the theme and font ids valid in a note's front matter (palette-light/palette-dark and font keys).
get_skill — Use this to read the full pst.md guide (SKILL.md) before your first publish: every tool and its arguments, the REST equivalents, OAuth, appearance front matter, one-time notes, and exactly what Markdown renders.
check_scheme — Use this to check a candidate terminal scheme BEFORE authoring or importing it: it runs the scheme through the SAME derivation every pst.md theme gets and reports what would ship.
create_note — Use this when the user wants Markdown published as a pst.md note (a shareable link, a paste, a private note, an expiring or one-time note).
get_note — Use this to read a note by id - ALWAYS safe: it never consumes a burn-after-read note (for a burn note it returns metadata with the content withheld).
consume_note — Use this ONLY when the user explicitly intends to spend a burn-after-read note's single read: it returns the content and then the note is erased for everyone.
update_note — Use this to edit a note the user owns.
delete_note — Use this ONLY when the user explicitly asks to permanently delete a specific note they own - pass the exact note id; never guess one, and confirm intent when the request is ambiguous.