AGENT ACCESS / NO KEY REQUIRED

Ask once. Search everything.

One tool query ranks curated Andrew’s Freebies offers and live licensed repositories together. The underlying 5,353 local records remain available without authentication.

One natural-language tool search.

Call search_tools once for any software need. It returns one ordered list with provenance on each result. Use search_entitlements separately for cash back, coupons, bonuses, rebates, credits, shopping rewards, public services, and loyalty perks.

GET /api/v1/search?q=edit+PDFs
&limit=12

200 OKapplication/json

{
  "query": "edit PDFs",
  "status": "complete",
  "count": 12,
  "items": [{
    "result_type": "catalog-offer",
    "name": "Adobe Acrobat Pro"
  }, {
    "result_type": "open-source-repository",
    "full_name": "owner/repository"
  }]
}

PUBLIC SURFACES

Choose the interface your agent already understands.

Unified tool search/api/v1/search?q=video+editingCatalog + live JSON↗Single record/api/v1/trials/adobe-photoshopJSON↗Redeemable value/api/v1/entitlements?q=Bank+of+America+cash+back&focus=redeemable-valueJSON↗Single benefit/api/v1/entitlements/bankameridealsJSON↗Entitlement taxonomy/api/v1/taxonomyJSON↗Coverage ledger/api/v1/sourcesJSON↗Verification history/api/v1/verificationAppend-only JSON↗Freshness summary/api/v1/freshnessLatest-state JSON↗Expiration reports/api/v1/flagsAppend-only JSON↗Tool discovery/openapi.jsonOpenAPI 3.1↗MCP/api/mcpStreamable HTTP↗Agent guide/llms.txtPlain text↗Full context/llms-full.txtPlain text↗Bulk catalog/trials.ndjsonNDJSON↗Spreadsheet export/trials.csvCSV↗Benefits export/entitlements.csvCSV↗

MODEL CONTEXT PROTOCOL

Ten small tools. One tool search.

The MCP endpoint exposes search_tools as the single entry point for curated offers and live repositories, alongside benefit search, record retrieval, taxonomy, coverage, freshness, verification history, and flag_expired_deal. Flags and audits are append-only review signals; they never remove or change a catalog record.

{
  "mcpServers": {
    "andrews-freebies": {
      "url": "https://YOUR-HOST/api/mcp"
    }
  }
}

FRESHNESS POLICY

Record status is not an audit result.

A record's discovery status describes the evidence attached to its catalog entry. Field-level verification is a separate, append-only history that records URL health, offer availability, and whether normalized terms matched. Use freshness for latest-state coverage and verification for audit evidence. The coverage goal is 100% attempted on schedule—not 100% confirmed. A blocked page, fetch error, or unknown result is never evidence that an offer expired, and no audit removes a record.

RETRIEVAL POLICY

One list. Provenance intact.

Do not make the user choose a source. Search once, then use result_type and result_source to explain what each result is. A detected repository license supports open-source discovery, but it does not establish that hosting, deployment, support, or connected services are free. Read the canonical taxonomy before interpreting benefit categories or cost filters.