Quickstart

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\\Claude\\claude_desktop_config.json
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

// Project: .cursor/mcp.json  |  Global: ~/.cursor/mcp.json
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

// Refer to your client's documentation for config file location.
// The mcpServers schema is standard across MCP-compatible clients.
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

curl https://api.docketlayer.ai/v2/status

import httpx

resp = httpx.get("https://api.docketlayer.ai/v2/status")
print(resp.json())

const resp = await fetch("https://api.docketlayer.ai/v2/status");
const data = await resp.json();
console.log(data);

import httpx, json, base64, os
from solders.keypair import Keypair
from solders.pubkey import Pubkey
from solana.rpc.api import Client
from solana.transaction import Transaction
from spl.token.instructions import transfer, TransferParams, get_associated_token_address

ENDPOINT   = "https://api.docketlayer.ai/v2/case"
PARAMS     = {"court_code": "nysd", "case_id": "1:24-cv-09822"}
USDC_MINT  = Pubkey.from_string("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
TOKEN_PROG = Pubkey.from_string("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA")

# 1. Probe — expect 402 with X-Payment-Requirements
probe        = httpx.get(ENDPOINT, params=PARAMS)
assert probe.status_code == 402
requirements = json.loads(probe.headers["X-Payment-Requirements"])
receiver     = Pubkey.from_string(requirements["payTo"])
amount       = int(requirements["maxAmountRequired"])  # 990000 = $0.99 in USDC base units

# 2. Build and sign the USDC transfer
payer  = Keypair.from_base58_string(os.environ["WALLET_PRIVATE_KEY"])
client = Client("https://solana-mainnet.publicnode.com")

src_ata  = get_associated_token_address(payer.pubkey(), USDC_MINT)
dest_ata = get_associated_token_address(receiver, USDC_MINT)

ix = transfer(TransferParams(
    program_id=TOKEN_PROG,
    source=src_ata,
    dest=dest_ata,
    owner=payer.pubkey(),
    amount=amount,
))
blockhash = client.get_latest_blockhash().value.blockhash
tx = Transaction(recent_blockhash=blockhash, fee_payer=payer.pubkey())
tx.add(ix)
tx.sign(payer)

# Wrap in x402 payload and base64-encode
payment = base64.b64encode(json.dumps({
    "x402Version": 1,
    "scheme":      "exact",
    "network":     "solana-mainnet",
    "payload":     {"transaction": base64.b64encode(bytes(tx)).decode()},
}).encode()).decode()

# 3. Retry with x402-payment header
resp = httpx.get(ENDPOINT, params=PARAMS, headers={"x402-payment": payment})
print(resp.json())

import {
  Connection, Keypair, PublicKey, Transaction,
} from "@solana/web3.js";
import {
  createTransferInstruction, getAssociatedTokenAddress, TOKEN_PROGRAM_ID,
} from "@solana/spl-token";

const ENDPOINT  = "https://api.docketlayer.ai/v2/case";
const PARAMS    = new URLSearchParams({ court_code: "nysd", case_id: "1:24-cv-09822" });
const USDC_MINT = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");

// 1. Probe — expect 402 with X-Payment-Requirements
const probe        = await fetch(`${ENDPOINT}?${PARAMS}`);
const requirements = JSON.parse(probe.headers.get("X-Payment-Requirements"));
const receiver     = new PublicKey(requirements.payTo);
const amount       = BigInt(requirements.maxAmountRequired); // 990000n = $0.99

// 2. Build and sign the USDC transfer
const payer      = Keypair.fromSecretKey(YOUR_SECRET_KEY);
const connection = new Connection("https://solana-mainnet.publicnode.com");

const srcAta  = await getAssociatedTokenAddress(USDC_MINT, payer.publicKey);
const destAta = await getAssociatedTokenAddress(USDC_MINT, receiver);

const tx = new Transaction().add(
  createTransferInstruction(srcAta, destAta, payer.publicKey, amount, [], TOKEN_PROGRAM_ID)
);
tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
tx.feePayer = payer.publicKey;
tx.sign(payer);

// Wrap in x402 payload and base64-encode
const payment = Buffer.from(JSON.stringify({
  x402Version: 1,
  scheme:      "exact",
  network:     "solana-mainnet",
  payload:     { transaction: Buffer.from(tx.serialize()).toString("base64") },
})).toString("base64");

// 3. Retry with x402-payment header
const resp = await fetch(`${ENDPOINT}?${PARAMS}`, {
  headers: { "x402-payment": payment },
});
console.log(await resp.json());

curl -G https://api.docketlayer.ai/v2/case \
  -d court_code=nysd \
  -d case_id=1:24-cv-09822 \
  -H "x402-payment: <base64_x402_payload>"

resp = httpx.get(
    "https://api.docketlayer.ai/v2/case",
    params={"court_code": "nysd", "case_id": "1:24-cv-09822"},
    headers={"x402-payment": payment},
)
print(resp.json())

const resp = await fetch(
  "https://api.docketlayer.ai/v2/case?court_code=nysd&case_id=1:24-cv-09822",
  { headers: { "x402-payment": payment } }
);
console.log(await resp.json());

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\\Claude\\claude_desktop_config.json
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

// Project: .cursor/mcp.json  |  Global: ~/.cursor/mcp.json
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

// Refer to your client's documentation for config file location.
// The mcpServers schema is standard across MCP-compatible clients.
{
  "mcpServers": {
    "docketlayer": {
      "command": "npx",
      "args": ["-y", "@docketlayer/mcp-server"],
      "env": {
        "DOCKETLAYER_WALLET_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

"What is the current status of case 1:24-cv-09822 in the Southern District of New York?"

"Pull the full docket for D. Delaware patent case 1:23-cv-00917. I need all entries from the past 30 days."

"Check Federal Court of Canada case T-1045-24 and summarize anything filed since April 1."

"Which circuits does DocketLayer cover? I'm tracking a Ninth Circuit appeal."