{
  "schema_version": "1.0",
  "name": "Benefits City",
  "description": "US bank-account, savings and credit-card signup bonuses, each checked against a named source, with expiry dates. Search, compare and time-check offers over MCP or REST.",
  "url": "https://aiagentscity.com/benefits",
  "api_base": "https://aiagentscity.com/benefits/api",
  "openapi": "https://aiagentscity.com/benefits/openapi.json",
  "mcp": {
    "url": "https://aiagentscity.com/benefits/mcp",
    "transport": "streamable-http",
    "server_card": "https://aiagentscity.com/benefits/.well-known/mcp/server-card.json"
  },
  "skill": "https://aiagentscity.com/benefits/skill.md",
  "docs": "https://aiagentscity.com/benefits/agents",
  "auth": {
    "type": "none",
    "description": "No credential is required; the API is open and read-only. See https://aiagentscity.com/benefits/auth.md."
  },
  "pricing": {
    "model": "free",
    "amount_usd": 0,
    "description": "Free. No signup, no API key, no paywall."
  },
  "capabilities": [
    {
      "id": "search_bonuses",
      "description": "Search offers by type, state, minimum value, direct-deposit requirement or keyword; sorted by bonus value.",
      "endpoint": "https://aiagentscity.com/benefits/api/search",
      "method": "GET",
      "free": true
    },
    {
      "id": "expiring_soon",
      "description": "Offers whose stated expiry falls within the next N days, soonest first.",
      "endpoint": "https://aiagentscity.com/benefits/api/expiring",
      "method": "GET",
      "free": true
    },
    {
      "id": "compare_bonuses",
      "description": "Side-by-side comparison of 2 to 4 offers (?ids=a,b).",
      "endpoint": "https://aiagentscity.com/benefits/api/compare",
      "method": "GET",
      "free": true
    },
    {
      "id": "get_bonus",
      "description": "Full detail for one offer.",
      "endpoint": "https://aiagentscity.com/benefits/api/bonuses/{id}",
      "method": "GET",
      "free": true
    },
    {
      "id": "bonuses_feed",
      "description": "The full list of currently served offers.",
      "endpoint": "https://aiagentscity.com/benefits/api/bonuses.json",
      "method": "GET",
      "free": true
    },
    {
      "id": "insights",
      "description": "Citable statistics (counts, medians, shares) with denominators and a data date.",
      "endpoint": "https://aiagentscity.com/benefits/api/insights",
      "method": "GET",
      "free": true
    },
    {
      "id": "stats",
      "description": "Live counts, combined headline value, and offers expiring soon.",
      "endpoint": "https://aiagentscity.com/benefits/api/stats",
      "method": "GET",
      "free": true
    }
  ],
  "contact": "bonuses@aiagentscity.com",
  "legal": "AI Agent City. Information only, not financial advice. Offer terms can change; confirm with the issuer before applying. See /disclosure for how this site is paid."
}