Authenticate to CourtListener using 'Authorization: Token YOUR_TOKEN'
POST to https://www.courtlistener.com/api/rest/v4/prayers/ with a JSON body containing the recap_document ID of the unavailable document to register your interest
Register a webhook endpoint in your CourtListener account settings that listens for the PRAYER_GRANTED event type
When another user or the system retrieves that document, CourtListener POSTs a webhook event to your URL containing the prayer_id, document_id, and status
On receipt of the PRAYER_GRANTED webhook, fetch the document details from /api/rest/v4/recap-documents/DOCUMENT_ID/ to obtain the download URL
Known gotchas
A prayer is fulfilled only when someone else purchases the document through RECAP Fetch or uploads it; there is no guaranteed fulfillment time
Your webhook endpoint must return HTTP 2xx within a reasonable timeout; CourtListener will retry failed deliveries but persistent failures will disable the webhook
You can list your outstanding prayers via GET /api/rest/v4/prayers/ to audit or cancel pending requests
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp