MCP server

LFMarkdown speaks the Model Context Protocol, so an assistant can publish and read documents for you without leaving the conversation. The connection is tied to your account, and you approve it once in your browser.

Connect

The server is at https://lfmarkdown.com/mcp. It uses the streamable HTTP transport, and it authenticates with OAuth: there is no API key to create, copy or lose.

With Claude Code:

claude mcp add --transport http lfmarkdown https://lfmarkdown.com/mcp

In any client that asks for a remote MCP server, paste the URL above. The first tool call opens your browser, you sign in if you are not already, and you approve the connection. That is the whole setup.

What your assistant can do

Tool	What it does
list_documents	Lists the documents your account has published, newest first
get_document	Downloads the original Markdown of any live document, by slug or URL
publish_document	Publishes a new document and returns its public link
delete_document	Deletes one of your own documents, permanently

Reading and publishing are separate permissions. The approval screen names the ones the client asked for, and a client granted read only cannot publish or delete anything.

How the sign in works

Nothing is pasted anywhere. The client discovers the authorization server from the endpoint itself, registers itself, and runs a standard OAuth 2.1 authorization code flow with PKCE. Access tokens last two hours and are refreshed silently; they are stored here as digests, never in the clear.

You approve one client at a time, and approval means one account: the tools only ever see the documents of the account that clicked Allow.

Worth knowing before you connect

Documents are public. Anyone holding the link can read one, so an assistant publishing on your behalf should never be handed a secret.

Publishing is final. A document cannot be edited after the fact, which is why the tool list has a delete rather than an update.

Deleting is final too. delete_document removes the document immediately, with no confirmation step of its own, so it is worth telling your assistant to ask you first.