{
  "name": "MailPulse",
  "description": "Send a REAL physical letter — US First-Class, US Certified Mail (with optional electronic return receipt), or international — via Lob's Print & Mail network. ACTION API, not a data lookup: paying causes a real letter to be printed and mailed. Flow: free quote -> paid send -> optional status/tracking poll. Pay-per-call via x402 on Base.",
  "url": "https://mailpulse.theaslangroupllc.com",
  "version": "1.0.0",
  "capabilities": [
    "send-physical-letter",
    "us-first-class-mail",
    "us-certified-mail",
    "certified-mail-return-receipt",
    "international-letter",
    "address-verification",
    "usps-deliverability-check",
    "usps-tracking",
    "mail-status-poll",
    "agentic-commerce-action",
    "physical-world-action"
  ],
  "target_users": [
    "Agents that need to send a real letter as the outcome of a workflow (legal notice, demand letter, formal correspondence, direct mail)",
    "Debt/collections and legal-tech agents sending compliant physical notices",
    "Business-automation agents that need certified-mail proof of delivery",
    "Any agent needing to reach a recipient who cannot be reached digitally",
    "International correspondence where email/digital delivery isn't viable or verifiable"
  ],
  "data_sources": [
    "Lob (lob.com) — Print & Mail API: printing, envelopes, USPS induction, tracking, and US/international address verification"
  ],
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc"
  },
  "endpoints": [
    {
      "path": "/api/health",
      "method": "GET",
      "description": "Liveness check + current mode (test/live).",
      "price_usd": 0,
      "payment_required": false
    },
    {
      "path": "/api/verify-address",
      "method": "POST",
      "description": "Deliverability check (US + international) via Lob address verification, before you pay to print.",
      "parameters": [ { "name": "address", "required": true } ],
      "price_usd": 0.01,
      "payment_required": true
    },
    {
      "path": "/api/quote",
      "method": "POST",
      "description": "Free, exact price quote + signed quote_id for a prospective letter. No Lob call, no charge.",
      "parameters": [
        { "name": "service", "required": true },
        { "name": "to", "required": true },
        { "name": "from", "required": true },
        { "name": "content", "required": true },
        { "name": "pages_estimate", "required": false }
      ],
      "price_usd": 0,
      "payment_required": false
    },
    {
      "path": "/api/letters",
      "method": "POST",
      "description": "THE action: prints and mails a real physical letter once payment settles. Requires a verified quote_id and a client_request_id for idempotency. Price varies $3.00-$14.00 by service; every order capped at $25.00.",
      "parameters": [
        { "name": "quote_id", "required": true },
        { "name": "issued_at", "required": true },
        { "name": "amount_micro", "required": true },
        { "name": "service", "required": true },
        { "name": "to", "required": true },
        { "name": "from", "required": true },
        { "name": "content", "required": true },
        { "name": "client_request_id", "required": true }
      ],
      "price_usd_min": 3.00,
      "price_usd_max": 14.00,
      "payment_required": true
    },
    {
      "path": "/api/letters/{id}",
      "method": "GET",
      "description": "Cheap status/USPS tracking poll for a previously sent letter.",
      "parameters": [ { "name": "id", "required": true } ],
      "price_usd": 0.005,
      "payment_required": true
    }
  ],
  "agent_workflow_examples": [
    "Send a certified legal notice: /api/verify-address (check recipient) -> /api/quote?service=certified -> /api/letters -> /api/letters/{id} (poll for tracking)",
    "Send a routine first-class letter: /api/quote?service=standard -> /api/letters",
    "International correspondence: /api/quote?service=international (to.address_country != US) -> /api/letters"
  ],
  "key_facts": [
    "This is an ACTION API — paying causes a real physical letter to be printed and mailed, not a data return",
    "Every response carries mode: \"test\" or \"live\" — test mode is the default and mails nothing physical",
    "The submitted \"from\" address is the sender of record; The Aslan Group LLC is a paid conduit only, never the sender",
    "certified / certified_return_receipt are US-domestic only; use international for non-US destinations",
    "v1 supports letters only, 1-6 pages, flat price per service (no per-page charge)",
    "No refunds once a letter is accepted for print (matches Lob's own policy) — except for our error"
  ],
  "openapi": "https://mailpulse.theaslangroupllc.com/openapi.json",
  "llms_txt": "https://mailpulse.theaslangroupllc.com/llms.txt",
  "contact": "https://mailpulse.theaslangroupllc.com"
}