# AgentDeals — Full Reference

> 1,493 developer tool deals across 60 categories. Free tiers, startup credits, and pricing change tracking. Of the 1,493 entries we hold, 439 carry terms a read confirmed in the last 90 days.

## MCP Connection

Endpoint: https://agentdeals.dev/mcp
Transport: Streamable HTTP (POST/GET/DELETE)

```json
{
  "mcpServers": {
    "agentdeals": {
      "url": "https://agentdeals.dev/mcp"
    }
  }
}
```

## Tool Schemas

### search_deals
Find free tiers, startup credits, and developer deals for cloud infrastructure, databases, hosting, CI/CD, monitoring, auth, AI services, and more.

Parameters:
- query (string, optional): Keyword search (vendor names, descriptions, tags)
- category (string, optional): Filter by category. Pass "list" to get all categories with counts.
- vendor (string, optional): Get full details for a specific vendor (fuzzy match). Returns alternatives.
- eligibility (enum, optional): public, accelerator, oss, student, fintech, geographic, enterprise
- sort (enum, optional): vendor (A-Z), category, newest
- since (string, optional): ISO date (YYYY-MM-DD). Only return deals whose catalogue date is on or after this date.
- limit (number, optional): Max results (default: 20)
- offset (number, optional): Pagination offset (default: 0)

### plan_stack
Plan a technology stack with cost-optimized infrastructure choices.

Parameters:
- mode (enum, required): recommend, estimate, or audit
- use_case (string, optional): What you're building (for recommend mode)
- services (array of strings, optional): Current vendor names (for estimate/audit mode)
- scale (enum, optional): hobby, startup, growth (for estimate mode)
- requirements (array of strings, optional): Specific infra needs (for recommend mode)

### compare_vendors
Compare developer tools and services side by side.

Parameters:
- vendors (array of strings, required): 1 or 2 vendor names. 1 = risk check, 2 = side-by-side comparison.
- include_risk (boolean, optional): Include risk assessment (default: true)

### track_changes
Track recent pricing changes across developer tools.

Parameters:
- since (string, optional): ISO date (YYYY-MM-DD). Default: 30 days ago, and only when no other filter is passed — a request carrying type, vendor, vendors, categories or category searches the whole change log unless since says otherwise. The filter compares against each record's date. Where date_meaning is "effective", that is the day the change took effect; where it is "discovered", it is the day we recorded the change, and when it took effect is unknown. Every response states the window it applied under date_window.
- change_type (enum, optional): free_tier_removed, limits_reduced, restriction, limits_increased, new_free_tier, new_tier, pricing_restructured, open_source_killed, pricing_model_change, startup_program_expanded, pricing_postponed, product_deprecated, rebranded
- vendor (string, optional): Filter to one vendor. Matched by case-insensitive substring, not by exact name: vendor=Pilot returns GitHub Copilot's records and category=ai returns Email's. Nothing is narrowed on your behalf, so read name_match, which every response carries: it names what this filter matched and whether each match was exact.
- vendors (string, optional): Comma-separated vendor names. Matched by case-insensitive substring, not by exact name: vendor=Pilot returns GitHub Copilot's records and category=ai returns Email's. Nothing is narrowed on your behalf, so read name_match, which every response carries: it names what this filter matched and whether each match was exact.
- categories (string, optional): Comma-separated category names. Matched by case-insensitive substring, not by exact name: vendor=Pilot returns GitHub Copilot's records and category=ai returns Email's. Nothing is narrowed on your behalf, so read name_match, which every response carries: it names what this filter matched and whether each match was exact.
- include_expiring (boolean, optional): Include upcoming expirations (default: true)
- lookahead_days (number, optional): Days to look ahead for expirations (default: 30)

## REST API Endpoints

- GET /api/offers — Search deals (params: q, category, eligibility_type, sort, limit, offset)
- GET /api/categories — List all categories with counts, what each name holds, and the other names answering the same question
- GET /api/changes — Pricing changes (params: since, type, vendor, vendors, category, categories, limit, offset, include_retracted, include_index_housekeeping)
- GET /api/new — Recently added offers (params: days)
- GET /api/newest — Newest deals (params: since, limit, category)
- GET /api/compare — Compare two vendors (params: a, b)
- GET /api/details/:vendor — Vendor details (params: alternatives)
- GET /api/vendor-risk/:vendor — Vendor risk assessment
- GET /api/stack — Stack recommendation (params: use_case, requirements)
- GET /api/costs — Free tier coverage only, not paid usage (params: services, scale)
- GET /api/audit-stack — Stack audit (params: services)
- GET /api/expiring — Expiring deals (params: days)
- GET /api/digest — Weekly pricing digest
- GET /api/digest/weekly — Formatted weekly digest (params: format=json|markdown|html, limit, weeks_ago)
- GET /api/openapi.json — OpenAPI 3.0 specification
- GET /api/docs — Swagger UI documentation
- GET /api/feed — Atom feed of pricing changes
- GET /api/pageviews — Page view analytics

## Categories (60)

- AI / ML (87 offers)
- AI Coding (15 offers)
- Analytics (41 offers)
- API Development (41 offers)
- API Gateway (6 offers)
- Auth (31 offers)
- Background Jobs (5 offers)
- Browser Automation (10 offers)
- CDN (20 offers)
- CI/CD (38 offers)
- Cloud Hosting (61 offers)
- Cloud IaaS (15 offers)
- Cloud Storage (9 offers)
- Code Quality (20 offers)
- Communication (17 offers)
- Communication & Messaging (8 offers)
- Consumer Email (4 offers)
- Container Registry (9 offers)
- Databases (45 offers)
- Design (95 offers)
- Design & Creative (6 offers)
- Dev Utilities (109 offers)
- Diagramming (10 offers)
- DNS & Domain Management (29 offers)
- Documentation (7 offers)
- Education (6 offers)
- Email (55 offers)
- Error Tracking (15 offers)
- Feature Flags (9 offers)
- Forms (29 offers)
- Headless CMS (15 offers)
- IDE & Code Editors (44 offers)
- Infrastructure (14 offers)
- Localization (14 offers)
- Logging (14 offers)
- Low-Code Platforms (15 offers)
- Maps/Geolocation (20 offers)
- Messaging (28 offers)
- Mobile Development (9 offers)
- Monitoring (59 offers)
- Notebooks & Data Science (9 offers)
- Password Managers (7 offers)
- Payments (16 offers)
- Productivity & Notes (16 offers)
- Project Management (49 offers)
- Search (5 offers)
- Secrets Management (4 offers)
- Security (54 offers)
- Server Management (7 offers)
- Source Control (14 offers)
- Startup Perks (34 offers)
- Status Pages (6 offers)
- Storage (55 offers)
- Team Collaboration (34 offers)
- Testing (45 offers)
- Tunneling & Networking (16 offers)
- Video (6 offers)
- VPN & Privacy (3 offers)
- Web Scraping (22 offers)
- Workflow Automation (7 offers)

## Example Queries

1. "What databases have a free tier?" → search_deals with category="Databases"
2. "Compare Supabase and Neon" → compare_vendors with vendors=["Supabase", "Neon"]
3. "What free tier changes happened this month?" → track_changes with since="2026-03-01"
4. "Recommend a stack for a Next.js SaaS app" → plan_stack with mode="recommend", use_case="Next.js SaaS app"
5. "Is Heroku's free tier still available?" → search_deals with vendor="Heroku"