Using DocketLayer with Cursor

Guides  ·  AI Agents

The DocketLayer MCP server integrates with Cursor's agent tooling, letting the Cursor agent query court dockets and check case status as part of a coding or research workflow. Configure it once; the agent discovers the available tools automatically and decides when to call them.

Configure Cursor

Add DocketLayer to your Cursor MCP configuration. Cursor supports both a global configuration and a project-level override:

• Global: ~/.cursor/mcp.json
• Project: .cursor/mcp.json in the project root

// Free tools only — no payment required
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"]
    }
  }
}

// All tools — paid queries settled via x402
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Reload the Cursor window after saving (Cmd+Shift+P → Reload Window) to pick up the new configuration.

Free Tools

Three tools require no wallet and no payment:

• docketlayer_status — Returns current API status and the full list of covered courts with their codes and coverage levels.
• docketlayer_court_list — Lists all courts with court_code, name, jurisdiction, and expected case ID format. Accepts an optional include_planned flag. Use this to find the right court code before running a paid query.
• docketlayer_pricing — Returns the current pricing model and payment protocol details.

Paid Tools

Four tools require a funded Solana wallet with USDC. Payment is handled automatically — the MCP server signs and submits the x402 transaction, and the agent receives the result without any manual payment step.

• docketlayer_case_query — Queries a case for current context and recent docket activity. Requires case_id and court_code. Pass last_checked as an ISO-8601 timestamp to receive only activity since that point. Costs $0.99.
• docketlayer_case_monitor — Checks whether a case has changed since a given timestamp, without returning the full docket payload. Requires last_checked. Costs $0.99.
• docketlayer_case_batch — Queries up to 50 cases in a single call. Each case that returns a result costs $0.99; cases that return errors are not billed.
• docketlayer_wallet_info — Returns the signing-key state for the configured wallet and recent callback delivery history. Costs $0.99.