v2 MCP

Hosted MCP endpoint (JSON-RPC 2.0 / Streamable HTTP)

EP-023-T4 (implemented). A thin adapter over the same service layer as the v2 API. Authentication — API key (Authorization: Bearer p2m_...); the tools respect the key's scopes, tier limits, and ownership. JSON-RPC methods: initialize, tools/list, tools/call, ping; notifications (without id) → 202 with no body. Tools: pdf_to_markdown_create_job_from_url/_from_upload (require scope jobs:create), _list_jobs/_get_job (jobs:read), _get_markdown (jobs:download), _delete_job (jobs:delete), _get_limits. tools/call responses include slot_usage and tier. For MCP client setup — see docs/architecture.md (Hosted MCP).

post/api/v2/mcp

Request

  • Base URL: https://pdf2md.dev
  • URL: https://pdf2md.dev/api/v2/mcp
  • Auth: HTTP bearer

Request body

object required

JSON-RPC 2.0 request {jsonrpc,id,method,params}

Response

JSON-RPC response (result or error)

object required

Changes

No recorded changes to this operation across all 1 revision of this API.