{"serverInfo":{"name":"AgentsMarkdown MCP","version":"1.0.0"},"protocolVersion":"2025-06-18","transport":{"type":"streamable-http","endpoint":"https://agentsmarkdown.com/mcp"},"capabilities":{"tools":{"listChanged":false}},"tools":[{"name":"agentsmarkdown.create_review_task","description":"Create an owner-authorized assignment with a dedicated suggest link. Reuse requestId for safe retries.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"title":{"type":"string","maxLength":120},"instructions":{"type":"string","maxLength":8000},"requestId":{"type":"string","maxLength":80,"description":"Stable caller request ID for retrying task creation."}},"required":["doc","title","instructions","requestId"],"additionalProperties":false}},{"name":"agentsmarkdown.list_review_tasks","description":"List assignments visible to owner access or this exact task link.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"before":{"type":"string","description":"The nextBefore task cursor returned by the prior page."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.get_review_task","description":"Read a review assignment and its report.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"taskId":{"type":"string"}},"required":["doc","taskId"],"additionalProperties":false}},{"name":"agentsmarkdown.start_review_task","description":"Start an assignment through its matching suggest link.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"taskId":{"type":"string"}},"required":["doc","taskId"],"additionalProperties":false}},{"name":"agentsmarkdown.report_review_task","description":"Submit the reviewed document version, summary, and existing comment or suggestion IDs. The owner accepts suggestions manually.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"taskId":{"type":"string"},"reviewedVersion":{"type":"string","description":"The exact version returned when you read the document."},"summary":{"type":"string","maxLength":8000},"commentIds":{"type":"array","maxItems":100,"items":{"type":"string"},"description":"Existing comments in this document associated with the task; not an authorship assertion."},"suggestionIds":{"type":"array","maxItems":100,"items":{"type":"string"}}},"required":["doc","taskId","reviewedVersion","summary"],"additionalProperties":false}},{"name":"agentsmarkdown.close_review_task","description":"Close or cancel an owner-authorized assignment. This does not revoke the share link or accept suggestions.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"taskId":{"type":"string"}},"required":["doc","taskId"],"additionalProperties":false}},{"name":"agentsmarkdown.create_doc","description":"Creates a Markdown document and returns its ID, owner key, and share URL.","inputSchema":{"type":"object","properties":{"title":{"type":"string"},"content":{"type":"string","description":"The initial Markdown. A leading \"# Heading\" becomes the title."},"markdown":{"type":"string","description":"An alias for content, accepted for Markdown clients."},"kind":{"type":"string","enum":["plain","live"]}},"additionalProperties":false}},{"name":"agentsmarkdown.read_doc","description":"Reads document Markdown and its version for checked writes.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.replace_doc","description":"Replaces the document content. To detect conflicting edits, pass baseVersion from read_doc.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"content":{"type":"string"},"baseVersion":{"type":"string","description":"The version from read_doc. A stale value returns a conflict."},"label":{"type":"string","description":"Names this revision in history."}},"required":["doc","content"],"additionalProperties":false}},{"name":"agentsmarkdown.append_doc","description":"Appends Markdown after reading and checking the document version.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"text":{"type":"string"},"label":{"type":"string"}},"required":["doc","text"],"additionalProperties":false}},{"name":"agentsmarkdown.list_comments","description":"Lists comments and replies on a document.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.add_comment","description":"Adds a comment. Use find, line, or anchor to select its passage.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for 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}},{"name":"agentsmarkdown.list_suggestions","description":"Lists suggested edits on a document.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.add_suggestion","description":"Proposes an insertion, deletion, or replacement. Acceptance applies the edit to the document.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"type":{"type":"string","enum":["insert","delete","replace"]},"text":{"type":"string","description":"The replacement or inserted Markdown for insert and replace operations."},"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}},{"name":"agentsmarkdown.resolve_suggestion","description":"Accepts or rejects a pending suggestion. Requires edit access.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"suggestionId":{"type":"string"},"action":{"type":"string","enum":["accept","reject"]}},"required":["doc","suggestionId","action"],"additionalProperties":false}},{"name":"agentsmarkdown.create_share","description":"Creates a share link with view, comment, suggest, or edit access. Requires owner access.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"role":{"type":"string","enum":["view","comment","suggest","edit"]}},"required":["doc","role"],"additionalProperties":false}},{"name":"agentsmarkdown.set_published","description":"Publishes or unpublishes a document. Requires owner access. Published documents use /pub/{id} without a key.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"published":{"type":"boolean"}},"required":["doc","published"],"additionalProperties":false}},{"name":"agentsmarkdown.list_events","description":"Reads document activity. To wait for changes, use since and wait. The maximum wait is 55 seconds.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"since":{"description":"Sequence number, or \"latest\".","type":["number","string"]},"wait":{"type":"number","description":"The wait duration, from 0 to 55 seconds."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.generate_image","description":"Generates an image on your mere.run node and saves it as a document asset. Returns the asset URL and Markdown. To insert the result, use replace_doc, append_doc, or add_suggestion. Requires a mere.world session (Authorization: Bearer asess_...) with a running mere.run node; a share key alone is not enough.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"prompt":{"type":"string","description":"The image description, up to 2,000 characters."},"size":{"type":"string","enum":["square","wide","tall"],"description":"square 1024×1024, wide 1216×832, tall 832×1216. Default square."},"width":{"type":"number","description":"The width in pixels. Overrides size. The model constrains dimensions to its supported grid."},"height":{"type":"number","description":"The height in pixels. Overrides size."}},"required":["doc","prompt"],"additionalProperties":false}},{"name":"agentsmarkdown.transcribe_audio","description":"Transcribes speech on your mere.run node. Provide base64 audio or a same-origin asset URL from POST /api/docs/{id}/assets. Requires a mere.world session (Authorization: Bearer asess_...) with a running mere.run node; a share key alone is not enough.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"audio_data":{"type":"string","description":"The base64 audio, up to 8 MiB after decoding. Accepts a data: URI prefix."},"audio_url":{"type":"string","description":"The same-origin /f/ asset URL for uploaded audio."},"content_type":{"type":"string","description":"Audio MIME type for audio_data. Default audio/wav."},"language":{"type":"string","description":"Optional ISO language hint."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.ocr_image","description":"Extracts image text on your mere.run node. Provide base64 image data or a same-origin /f/ asset URL. Requires a mere.world session (Authorization: Bearer asess_...) with a running mere.run node; a share key alone is not enough.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"image_data":{"type":"string","description":"The base64 image, up to 6 MiB after decoding. Accepts a data: URI prefix."},"image_url":{"type":"string","description":"The same-origin /f/ asset URL for an uploaded image."},"content_type":{"type":"string","description":"Image MIME type for image_data: image/png, image/jpeg, image/webp, or image/gif. Default image/png."}},"required":["doc"],"additionalProperties":false}},{"name":"agentsmarkdown.speak_text","description":"Generates speech on your mere.run node and saves it as a document asset. Returns the asset URL and audio markup. Split text over 2,400 characters into multiple calls. Requires a mere.world session (Authorization: Bearer asess_...) with a running mere.run node; a share key alone is not enough.","inputSchema":{"type":"object","properties":{"doc":{"type":"string","description":"The document ID, share URL, or publication URL. Share URLs supply the key automatically."},"key":{"type":"string","description":"The share key for the required role. Omit for documents that you own or for published reads."},"text":{"type":"string","description":"The text to speak, up to 2,400 characters per call."},"voice":{"type":"string","description":"An optional voice description, such as \"a calm narrator\"."}},"required":["doc","text"],"additionalProperties":false}},{"name":"agentsmarkdown.get_skill","description":"Reads the agent API guide at /agents.md as Markdown.","inputSchema":{"type":"object","additionalProperties":false}}],"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. Media tools run on the signed-in user’s own mere.run node and need a mere.world session bearer. Full guide: get_skill.","documentationUrl":"https://agentsmarkdown.com/agents.md"}