{
  "tools": [
    {
      "name": "daily_new_companies",
      "description": "FREE, no key. Yesterday's (UK date) new Companies House incorporations grouped by SIC section/sector, with counts and example names and numbers. Also GET /daily/new-companies (?format=text).",
      "method": "GET",
      "path": "/daily/new-companies",
      "body": {
        "date": "YYYY-MM-DD (optional, last 31 days)"
      }
    },
    {
      "name": "company_status",
      "description": "FREE, no key. Companies House status by company number (status, name, incorporation/cessation dates, registered office postcode, has_insolvency_history) or by name (top matches with numbers). Cached up to 6 hours.",
      "method": "POST",
      "path": "/mcp (tools/call company_status)",
      "body": {
        "company_number": "string (e.g. 00445790)",
        "name": "string (alternative: name search)"
      }
    },
    {
      "name": "new_cos_pack",
      "description": "Paid pack of active UK companies matching an area/location string. Returns up to `size` companies (default 25). Requires Stripe Checkout (£0.49) then a one-time bearer token.",
      "method": "POST",
      "path": "/v1/packs/new-cos",
      "body": {
        "area": "string (required)",
        "size": "number (optional, default 25, max 100)"
      },
      "auth": "Authorization: Bearer <one-time-token> or ?token= after checkout"
    },
    {
      "name": "kyb_pack",
      "description": "Paid pack for one UK company number: profile, officers, people with significant control, recent filings, and indicators. Indicators are not a due-diligence or Know Your Business opinion. Requires Stripe Checkout (£0.49) then a one-time bearer token. Soft-Offer outbound is OFF.",
      "method": "POST",
      "path": "/v1/packs/kyb",
      "body": {
        "company_number": "string (required, e.g. 00000006)",
        "filing_limit": "number (optional, default 10, max 50)"
      },
      "auth": "Authorization: Bearer <one-time-token> or ?token= after checkout"
    },
    {
      "name": "redeem_pack",
      "description": "Redeem a paid Stripe Checkout session (success redirect). Returns new-cos or kyb pack JSON once, based on session product.",
      "method": "GET",
      "path": "/v1/packs/redeem?session_id=cs_..."
    },
    {
      "name": "new_cos_discover",
      "description": "Free peek: up to 5 active UK companies for an area/location (e.g. London). Cached 24h; searches last 120 days first, with possible undated fallback. Check date_of_creation; not guaranteed newest. For MCP tool discovery / samples. Soft-Offer outbound is OFF.",
      "method": "GET",
      "path": "/v1/discover/new-cos?area=London"
    }
  ],
  "mcp": {
    "endpoint": "/mcp",
    "transport": "streamable-http"
  },
  "one_liner": "AI-ready MCP tools for compliance / KYB / new-company agents. Free discover → £0.49 pack → JSON for your agent.",
  "outcome": "KYB and area-search company packs",
  "how_agents_use_this": "GET /v1/discover/new-cos?area=… → POST /v1/packs/kyb or /v1/packs/new-cos → Stripe £0.49 → Bearer once",
  "data_licence": "Companies House data under Open Government Licence. Not the official register.",
  "soft_offer_outbound": "off",
  "price_tiers": {
    "default": "£0.49 (STRIPE_PRICE_ID)",
    "pro": "£2.99 when STRIPE_PRICE_ID_PRO set",
    "deep": "£4.99 when STRIPE_PRICE_ID_DEEP set",
    "bundle": "£2–£2.49 when STRIPE_PRICE_ID_BUNDLE set"
  }
}