Docs

Cursor MCP Markdown Sharing

Connect mkdshare to Cursor and let the agent publish, share, and annotate markdown documents directly from your coding conversations.

Prerequisites

  • 1. Cursor installed (any recent version supports MCP).
  • 2. A free mkdshare account. Sign up with Google →
  • 3. An API token from mkdshare.dev/api-access.

Step 1 — Open MCP settings

In Cursor, go to Settings → Cursor Settings → MCP. Click Add new MCP server.

Step 2 — Enter the server details

Fill in these fields. Replace <your-token> with your API token.

Name mkdshare
Type http
URL https://mkdshare.dev/mcp
Header Authorization: Bearer <your-token>

Save the server. Cursor connects immediately — no restart needed.

Step 3 — Verify in Agent mode

Open the Agent panel ( Cmd+I ). The mkdshare tools should appear in the tool list. Ask the agent to confirm:

List my mkdshare documents.

Available tools

create_document Publish a markdown doc and get a shareable URL
get_document Read a document you have access to
update_document Edit a document you own
list_documents Browse all your documents
create_annotation Leave an inline comment on a specific passage
list_annotations Read all comments on a document

Example prompts for Agent mode

Publish this implementation plan as a mkdshare document and give me the link.
Create a markdown handoff for the feature I just built and publish it on mkdshare, restricted to @mycompany.com.
Read the annotations on mkdshare document abc123 and open a GitHub issue for each requested change.
Update the mkdshare document at slug abc123 with the latest version of the changelog.

Troubleshooting

Tools not appearing in Agent mode

Make sure the server type is set to http (not sse or stdio). MCP tools only appear in Agent mode, not in normal chat.

401 Unauthorized

Check that the Authorization header value starts with Bearer (with a space) followed by your token. Get a fresh token at mkdshare.dev/api-access.

Connection failed

Verify the URL is exactly https://mkdshare.dev/mcp with no trailing slash.

Create a free account to get your API token.