Skip to main content

​
Overview

POST /v2/mcp is DocketLayer’s remote MCP server. It implements the MCP Streamable HTTP transport (protocol version 2025-11-25) over JSON-RPC 2.0. Any MCP-compatible client can connect directly using the endpoint URL. Endpoint: https://api.docketlayer.ai/v2/mcp Transport: MCP Streamable HTTP — POST only. GET returns 405. Price: Free tools are free. Paid tools cost 0.99percall;batchcosts0.99 per call; batch costs 0.99 × N cases. Payment is passed as a payment_tx argument (or payment_tx_keys/payment_tx_deliveries for docketlayer_wallet_info) — see below.

​
Client configuration

​
Claude Code

{
  "mcpServers": {
    "docketlayer": {
      "url": "https://api.docketlayer.ai/v2/mcp",
      "transport": "http"
    }
  }
}

​
Claude Desktop

{
  "mcpServers": {
    "docketlayer": {
      "url": "https://api.docketlayer.ai/v2/mcp",
      "transport": "http"
    }
  }
}
No API key or wallet address is required at configuration time. Payment is handled per call via payment_tx.

​
Tools

​
Free tools

These tools require no payment and no wallet.
docketlayer_status Returns DocketLayer’s current operational status, covered courts, planned coverage, and API version. Equivalent to GET /v2/status. No parameters.
docketlayer_court_list Lists all courts DocketLayer covers or plans to cover, with court codes, names, jurisdictions, and case ID format patterns.
ParameterTypeRequiredDescription
include_plannedbooleanNoInclude planned courts. Default: true.
docketlayer_pricing Returns the pricing model — per-query cost, free endpoints, and payment protocol. No parameters.
Paid tools require a payment_tx argument: a base64-encoded signed Solana USDC transaction for $0.99 sent to DocketLayer’s settlement address. If payment_tx is omitted, the tool returns structured payment instructions — the recipient address and required amount — which an AI assistant can use to guide the user through payment.
docketlayer_case_query Queries a case for current context and recent docket activity. Equivalent to GET /v2/case. Costs $0.99.
ParameterTypeRequiredDescription
case_idstringYesCase identifier — e.g. 1:24-cv-01234
court_codestringYesCourt identifier — e.g. nysd
last_checkedstringNoISO-8601 timestamp. When supplied, response includes a delta block.
contextstringNobasic (default) or full
languagestringNoen or fr
filing_typesstringNoComma-separated filing types to filter the delta
payment_txstringNoBase64-encoded signed Solana transaction. Omit to receive payment instructions.
docketlayer_case_monitor Lightweight change check. Returns whether a case has new filings since last_checked. Equivalent to GET /v2/monitor. Costs $0.99.
ParameterTypeRequiredDescription
case_idstringYesCase identifier
court_codestringYesCourt identifier
last_checkedstringYesISO-8601 timestamp with timezone offset
payment_txstringNoBase64-encoded signed Solana transaction
docketlayer_case_batch Queries up to 50 cases in a single call. Costs $0.99 × N cases — the payment transaction must cover the full batch. Equivalent to POST /v2/cases/batch.
ParameterTypeRequiredDescription
queriesarrayYesArray of query objects — same fields as docketlayer_case_query
payment_txstringNoBase64-encoded signed Solana transaction sized for the full batch ($0.99 × N). Omit to receive payment instructions with estimated cost.
docketlayer_wallet_info Returns the wallet’s signing key state and optionally recent callback delivery history. Keys lookup costs 0.99.Addingdeliveryhistorycostsanadditional0.99. Adding delivery history costs an additional 0.99 (requires a second payment transaction). Default is keys only.
ParameterTypeRequiredDescription
include_deliveriesbooleanNoInclude callback delivery history. Requires payment_tx_deliveries. Default: false.
deliveries_limitnumberNoMax delivery records to return. Default: 50. Max: 200.
payment_tx_keysstringNoBase64-encoded signed Solana transaction for the keys lookup ($0.99). Omit to receive payment instructions.
payment_tx_deliveriesstringNoBase64-encoded signed Solana transaction for the deliveries lookup ($0.99). Required only when include_deliveries is true.

​
Request format

The endpoint accepts standard JSON-RPC 2.0 requests: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "docketlayer_case_query",
    "arguments": {
      "case_id": "1:24-cv-01234",
      "court_code": "nysd",
      "last_checked": "2026-01-01T00:00:00Z",
      "payment_tx": "base64encodedtx..."
    }
  }
}

​
Responses

HTTP statusMeaning
200Successful tool call — body contains JSON-RPC result
204notifications/initialized acknowledged — no body
405GET or other non-POST method rejected
Tool-level errors (payment missing, case not found, rate limited) are returned as JSON-RPC errors within a 200 response, not as HTTP error codes.