# LegalPulse

> Legal intelligence API — research-backed advocacy letters with statute citations, contract review, tenant rights, employment law, business formation, estate planning, consumer rights (FDCPA/FCRA), small claims, IP basics, and know your rights. Pay-per-query via x402 micropayments on Base.

## What This Is

LegalPulse is a pay-per-query API that synthesizes real-time legal research into structured, actionable guidance. The flagship endpoint generates complete, ready-to-send advocacy letters citing specific statutes — the kind that get hospitals to negotiate, debt collectors to back off, and insurance companies to reconsider denials.

Every response is powered by live Tavily legal research synthesized by Claude.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

GET /api/legal/letter?type={type}&situation={situation}&state={state}&amount={amount}&recipient={recipient}&outcome={outcome}
- Returns: complete, ready-to-send advocacy letter with statute citations, tips, escalation path
- type options: medical-bill | debt-settlement | insurance-appeal | tenant-dispute | employment-dispute | fdcpa-validation | fcra-dispute | contract-breach | refund-demand | general
- situation (required): describe what happened
- Price: $0.25

GET /api/legal/contract?clause={clause}&contract_type={type}
- Returns: plain-English clause explanation, risk level, red flags, what to negotiate, missing protections
- clause (required): paste clause text or describe it
- Price: $0.10

GET /api/legal/tenant?state={state}&issue={issue}
- Returns: tenant rights with statute citations, landlord obligations, notice deadlines, escalation options
- Both state and issue required
- Price: $0.10

GET /api/legal/employment?issue={issue}&state={state}
- Returns: employment law rights, EEOC deadlines (critical), non-compete enforceability, claim strength
- issue required; state improves specificity
- Price: $0.10

GET /api/legal/business?state={state}&entity_type={type}&situation={situation}
- Returns: entity comparison (LLC/S-Corp/C-Corp), costs, tax treatment, recommendation, formation steps
- state required
- Price: $0.10

GET /api/legal/estate?state={state}&situation={situation}
- Returns: estate planning checklist, probate threshold, avoidance tools, urgency flags, attorney cost estimates
- state required
- Price: $0.10

GET /api/legal/consumer?issue={issue}
- Returns: FDCPA/FCRA rights, prohibited conduct, complaint agencies, statutory damages available
- issue required
- Price: $0.10

GET /api/legal/small-claims?state={state}&situation={situation}
- Returns: dollar limit, filing fee, statute of limitations, evidence checklist, day-of-court tips, enforcement options
- state required
- Price: $0.08

GET /api/legal/ip?type={type}&situation={situation}
- Returns: automatic protections, registration benefits, process and costs, enforcement options
- type: trademark | copyright | patent | trade_secret; situation required
- Price: $0.10

GET /api/legal/rights?situation={situation}
- Returns: constitutional rights, exact words to say/avoid, what they can/cannot do, recording rights
- situation required
- Price: $0.08

## Discovery

- OpenAPI spec: https://legalpulse-rho.vercel.app/openapi.json
- Agent discovery: https://legalpulse-rho.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- /api/legal/letter uses maxTokens=3000 to accommodate full letter text
- letter_body field contains the complete letter with [PLACEHOLDER] fields for personalization
- Disclaimers appended automatically — not legal advice
- Cross-sell: use /api/legal/letter after /api/legal/consumer, /tenant, /employment, /rights for the action step