{"protocolVersion":"2025-06-18","serverInfo":{"name":"AgentsMarkdown MCP","version":"1.0.0"},"instructions":"Tools mirror the AgentsMarkdown HTTP API. Pass `doc` as an id or share URL and `key` for scoped access. Read then replace with baseVersion for safe writes. Full guide: get_skill.","capabilities":{"tools":{"listChanged":false}},"tools":[{"name":"agentsmarkdown.create_doc","description":"Create a new markdown document. Returns its id, owner key, and share URL.","inputSchema":{"type":"object","properties":{"title":{"type":"string"},"content":{"type":"string","description":"Initial markdown. A leading \"# Heading\" becomes the title."},"kind":{"type":"string","enum":["plain","live"]}},"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.read_doc","description":"Read a document as raw markdown, with its current version for safe writes.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."}},"required":["doc"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.replace_doc","description":"Replace the full document content. Pass baseVersion (from read_doc) for optimistic concurrency.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"content":{"type":"string"},"baseVersion":{"type":"string","description":"Version from read_doc; a stale value returns a conflict."},"label":{"type":"string","description":"Names this revision in history."}},"required":["doc","content"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.append_doc","description":"Append markdown to the end of a document (read + safe replace). Ideal for run logs.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"text":{"type":"string"},"label":{"type":"string"}},"required":["doc","text"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.list_comments","description":"List comments and replies on a document.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."}},"required":["doc"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.add_comment","description":"Add a comment, optionally anchored to text (find), a line, or a character range.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"body":{"type":"string"},"author":{"type":"string"},"find":{"type":"string","description":"Exact text to anchor to."},"line":{"type":"number","description":"1-based line number to anchor to."},"anchor":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}},"description":"Explicit character range.","additionalProperties":false}},"required":["doc","body"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.list_suggestions","description":"List proposed edits (suggestions) on a document.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."}},"required":["doc"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.add_suggestion","description":"Propose an insert, delete, or replace edit without changing canonical markdown until accepted.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"type":{"type":"string","enum":["insert","delete","replace"]},"text":{"type":"string","description":"Replacement or inserted markdown (insert/replace)."},"at":{"description":"\"start\", \"end\", or a character offset (insert)."},"author":{"type":"string"},"find":{"type":"string","description":"Exact text to anchor to."},"line":{"type":"number","description":"1-based line number to anchor to."},"anchor":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}},"description":"Explicit character range.","additionalProperties":false}},"required":["doc","type"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.resolve_suggestion","description":"Accept or reject a pending suggestion (requires edit access).","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"suggestionId":{"type":"string"},"action":{"type":"string","enum":["accept","reject"]}},"required":["doc","suggestionId","action"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.create_share","description":"Mint a scoped capability link (view, comment, suggest, or edit).","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"role":{"type":"string","enum":["view","comment","suggest","edit"]}},"required":["doc","role"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.set_published","description":"Publish or unpublish a document (owner access). Published docs read at /pub/{id} with no key.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"published":{"type":"boolean"}},"required":["doc","published"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.list_events","description":"Read the append-only activity feed. Use since + wait to long-poll for changes (wait up to 55s).","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"Document id, or a full share/publish URL (a ?key= in the URL is used automatically)."},"key":{"type":"string","description":"Share key granting the required role. Omit for account/agent-owned docs or published reads."},"since":{"description":"Sequence number, or \"latest\".","type":["number","string"]},"wait":{"type":"number","description":"Seconds to long-poll for new events (0-55)."}},"required":["doc"],"additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}},{"name":"agentsmarkdown.get_skill","description":"Fetch the full AgentsMarkdown agent guide (the /agents.md contract) as markdown.","inputSchema":{"type":"object","additionalProperties":false},"annotations":{"origin":"https://agentsmarkdown.com"}}]}