{
  "markdown": "# AgentDeals\n\n[![npm version](https://img.shields.io/npm/v/agentdeals.svg)](https://www.npmjs.com/package/agentdeals)\n[![npm downloads](https://img.shields.io/npm/dm/agentdeals.svg)](https://www.npmjs.com/package/agentdeals)\n\nAn MCP server that aggregates free tiers, startup credits, and developer tool deals — so your AI agent (or you) can find the best infrastructure offers without leaving the workflow.\n\nAgentDeals indexes real, verified pricing data from 1,500+ developer infrastructure vendors across 54 categories. Available on [npm](https://www.npmjs.com/package/agentdeals) for local use or as a hosted remote server. Connect any MCP-compatible client and search deals by keyword, category, or eligibility.\n\n**Live:** [agentdeals.dev](https://agentdeals.dev)\n\n## Install\n\n### Option A: Claude Code Plugin (one-click)\n\nInstall AgentDeals in Claude Code with a single command:\n\n```bash\nclaude plugin install robhunter/agentdeals\n```\n\nThis auto-configures the remote MCP server — no local setup needed. All 4 tools and 6 prompt templates are immediately available.\n\n### Option B: Claude Desktop Extension (one-click)\n\nInstall AgentDeals directly in Claude Desktop — no configuration needed:\n\n1. Download the latest `agentdeals.mcpb` from [Releases](https://github.com/robhunter/agentdeals/releases)\n2. Double-click the file to install in Claude Desktop\n3. All 4 tools and 6 prompt templates are immediately available\n\nOr browse for AgentDeals in Claude Desktop under **Settings > Extensions**.\n\n### Option C: npx (local stdio)\n\nNo server needed. Runs locally via stdin/stdout:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentdeals\"]\n    }\n  }\n}\n```\n\n### Option D: Remote HTTP\n\nConnect to the hosted instance — no install required:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"url\": \"https://agentdeals.dev/mcp\"\n    }\n  }\n}\n```\n\n### Quick Setup (.mcp.json)\n\nAdd AgentDeals to any project by dropping this `.mcp.json` in the project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"url\": \"https://agentdeals.dev/mcp\"\n    }\n  }\n}\n```\n\nThis works with Claude Code, Cursor, and other MCP-compatible clients that read `.mcp.json`.\n\n## Quick Start\n\n### Try these example queries\n\n**Find free database hosting:**\n```\nUse the search_deals tool:\n  query: \"database\"\n  category: \"Databases\"\n```\n\nReturns Neon (0.5 GiB free Postgres), Supabase (500 MB), MongoDB Atlas (512 MB shared cluster), PlanetScale alternatives, and more.\n\n**What pricing changes happened recently?**\n```\nUse the track_changes tool (no params for weekly digest, or filter):\n  since: \"2025-01-01\"\n```\n\nReturns tracked changes like PlanetScale free tier removal, Heroku free dynos sunset, Render pricing restructure, and other shifts.\n\n**Show deals I qualify for as a YC company:**\n```\nUse the search_deals tool:\n  eligibility: \"accelerator\"\n```\n\nReturns AWS Activate, Google Cloud for Startups, Microsoft Founders Hub, Stripe Atlas credits, and 150+ other startup program deals.\n\n## Client Configuration\n\nEach client supports both **local stdio** (via npx) and **remote HTTP**. Stdio is recommended for reliability and speed.\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n**Stdio (recommended):**\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentdeals\"]\n    }\n  }\n}\n```\n\n**Remote HTTP:**\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"url\": \"https://agentdeals.dev/mcp\"\n    }\n  }\n}\n```\n\nConfig location:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project or global config:\n\n**Stdio (recommended):**\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentdeals\"]\n    }\n  }\n}\n```\n\n**Remote HTTP:**\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"url\": \"https://agentdeals.dev/mcp\"\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot)\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n**Stdio (recommended):**\n```json\n{\n  \"servers\": {\n    \"agentdeals\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentdeals\"]\n    }\n  }\n}\n```\n\n**Remote HTTP:**\n```json\n{\n  \"servers\": {\n    \"agentdeals\": {\n      \"type\": \"http\",\n      \"url\": \"https://agentdeals.dev/mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to `.mcp.json` in your project root:\n\n**Stdio (recommended):**\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentdeals\"]\n    }\n  }\n}\n```\n\n**Remote HTTP:**\n```json\n{\n  \"mcpServers\": {\n    \"agentdeals\": {\n      \"type\": \"url\",\n      \"url\": \"https://agentdeals.dev/mcp\"\n    }\n  }\n}\n```\n\n## REST API\n\nAgentDeals also provides a REST API for programmatic access without MCP.\n\n### Search offers\n\n```bash\n# Search by keyword\ncurl \"https://agentdeals.dev/api/offers?q=database&limit=5\"\n\n# Filter by category\ncurl \"https://agentdeals.dev/api/offers?category=Databases&limit=10\"\n\n# Paginate results\ncurl \"https://agentdeals.dev/api/offers?limit=20&offset=40\"\n\n# Combine search + category\ncurl \"https://agentdeals.dev/api/offers?q=postgres&category=Databases\"\n```\n\nResponse:\n```json\n{\n  \"offers\": [\n    {\n      \"vendor\": \"Neon\",\n      \"category\": \"Databases\",\n      \"description\": \"Serverless Postgres with 0.5 GiB storage, 100 CU-hours/month compute on free tier\",\n      \"tier\": \"Free\",\n      \"url\": \"https://neon.com/pricing\",\n      \"tags\": [\"database\", \"postgres\", \"serverless\"]\n    }\n  ],\n  \"total\": 142\n}\n```\n\n### List categories\n\n```bash\ncurl \"https://agentdeals.dev/api/categories\"\n```\n\nResponse:\n```json\n{\n  \"categories\": [\n    { \"name\": \"Cloud Hosting\", \"count\": 45 },\n    { \"name\": \"Databases\", \"count\": 38 },\n    { \"name\": \"Developer Tools\", \"count\": 414 }\n  ]\n}\n```\n\n### More endpoints\n\n```bash\n# Recently added offers\ncurl \"https://agentdeals.dev/api/new?days=7\"\n\n# Pricing changes\ncurl \"https://agentdeals.dev/api/changes?since=2025-01-01\"\n\n# Vendor details\ncurl \"https://agentdeals.dev/api/details/Supabase?alternatives=true\"\n\n# Stack recommendation\ncurl \"https://agentdeals.dev/api/stack?use_case=saas\"\n\n# Cost estimation\ncurl \"https://agentdeals.dev/api/costs?services=Vercel,Supabase&scale=startup\"\n\n# Compare vendors\ncurl \"https://agentdeals.dev/api/compare?a=Supabase&b=Neon\"\n\n# Vendor risk check\ncurl \"https://agentdeals.dev/api/vendor-risk/Heroku\"\n\n# Stack audit\ncurl \"https://agentdeals.dev/api/audit-stack?services=Vercel,Supabase,Clerk\"\n\n# Server stats\ncurl \"https://agentdeals.dev/api/stats\"\n\n# Traffic attributed by client class (AI agent / crawler / browser), and web vs MCP\ncurl \"https://agentdeals.dev/api/traffic\"\n\n# OpenAPI spec\ncurl \"https://agentdeals.dev/api/openapi.json\"\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_deals` | Find free tiers, startup credits, and developer deals for cloud infrastructure, databases, hosting, CI/CD, monitoring, auth, AI services, and more. |\n| `plan_stack` | Plan a technology stack with cost-optimized infrastructure choices. Recommends free-tier services, estimates costs, or audits existing stacks. |\n| `compare_vendors` | Compare developer tools side by side — free tier limits, pricing tiers, and recent pricing changes. |\n| `track_changes` | Track recent pricing changes across developer tools — free tier removals, limit reductions, new free tiers, and expirations. |\n\n### search_deals\n\n**Parameters:**\n- `query` (string, optional) — Keyword search (vendor names, descriptions, tags)\n- `category` (string, optional) — Filter by category. Pass `\"list\"` to get all categories with counts.\n- `vendor` (string, optional) — Get full details for a specific vendor (fuzzy match). Returns alternatives.\n- `eligibility` (string, optional) — Filter: `public`, `accelerator`, `oss`, `student`, `fintech`, `geographic`, `enterprise`\n- `sort` (string, optional) — Sort: `vendor` (A-Z), `category`, `newest` (recently verified first)\n- `since` (string, optional) — ISO date. Only return deals verified/added after this date.\n- `limit` (number, optional) — Max results (default: 20)\n- `offset` (number, optional) — Pagination offset\n\n### plan_stack\n\n**Parameters:**\n- `mode` (string, required) — `recommend`, `estimate`, or `audit`\n- `use_case` (string, optional) — What you're building (for recommend mode)\n- `services` (array, optional) — Current vendor names (for estimate/audit mode)\n- `scale` (string, optional) — `hobby`, `startup`, `growth` (for estimate mode, default: hobby)\n- `requirements` (array, optional) — Specific infra needs (for recommend mode)\n\n### compare_vendors\n\n**Parameters:**\n- `vendors` (array, required) — 1 or 2 vendor names. 1 = risk check, 2 = side-by-side comparison.\n- `include_risk` (boolean, optional) — Include risk assessment (default: true)\n\n### track_changes\n\n**Parameters:**\n- `since` (string, optional) — ISO date. Default: 7 days ago.\n- `change_type` (string, optional) — Filter: `free_tier_removed`, `limits_reduced`, `limits_increased`, `new_free_tier`, `pricing_restructured`, etc.\n- `vendor` (string, optional) — Filter to one vendor\n- `vendors` (string, optional) — Comma-separated vendor names to filter\n- `include_expiring` (boolean, optional) — Include upcoming expirations (default: true)\n- `lookahead_days` (number, optional) — Days to look ahead for expirations (default: 30)\n\n## Use Cases\n\n### Agent-assisted infrastructure selection\n\nWhen your AI agent recommends infrastructure, it's usually working from training data — not current pricing. By connecting AgentDeals, the agent can:\n\n1. **Compare free tiers**: \"I'm evaluating Supabase vs Neon for a side project\" — use `compare_vendors` with both names\n2. **Check eligibility**: \"We're a YC W24 company, what credits can we get?\" — use `search_deals` with `eligibility: \"accelerator\"`\n3. **Verify before recommending**: Use `track_changes` to ensure the free tier hasn't been removed or reduced\n\n### Monitoring deal changes\n\nTrack pricing shifts that affect your stack:\n\n1. **Weekly digest**: Call `track_changes` with no params for a curated summary\n2. **Filter by vendor**: Call `track_changes` with `vendor: \"Vercel\"` to see if Vercel's pricing has changed\n3. **Filter by type**: Call `track_changes` with `change_type: \"free_tier_removed\"` to see which vendors have eliminated free tiers\n\n## Categories\n\nAI / ML, AI Coding, API Development, API Gateway, Analytics, Auth, Background Jobs, Browser Automation, CDN, CI/CD, Cloud Hosting, Cloud IaaS, Code Quality, Communication, Container Registry, DNS & Domain Management, Databases, Design, Dev Utilities, Diagramming, Documentation, Email, Error Tracking, Feature Flags, Forms, Headless CMS, IDE & Code Editors, Infrastructure, Localization, Logging, Low-Code Platforms, Maps/Geolocation, Messaging, Mobile Development, Monitoring, Notebooks & Data Science, Payments, Project Management, Search, Secrets Management, Security, Server Management, Source Control, Startup Perks, Startup Programs, Status Pages, Storage, Team Collaboration, Testing, Tunneling & Networking, Video, Web Scraping, Workflow Automation\n\n## Development\n\n```bash\nnpm install          # Install dependencies\nnpm run build        # Compile TypeScript\nnpm test             # Run tests (266 passing)\nnpm run serve        # Run HTTP server (port 3000)\nnpm start            # Run stdio server\n```\n\n### Local development with stdio\n\n```bash\nnpm start\n```\n\n### Local development with HTTP\n\n```bash\nnpm run serve\n# Server starts at http://localhost:3000\n# MCP endpoint: http://localhost:3000/mcp\n# Landing page: http://localhost:3000/\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PORT` | HTTP server port | `3000` |\n| `BASE_URL` | Base URL for canonical links, OG tags, sitemaps, and feeds | `https://agentdeals.dev` |\n| `GOOGLE_SITE_VERIFICATION` | Google Search Console verification code | _(none)_ |\n\n## Stats\n\n- **1,525** vendor offers across **54** categories\n- **57** tracked pricing changes\n- **4** MCP tools + **6** prompt templates + **17** REST API endpoints\n- **266** passing tests\n- Data verified as of 2026-03-14\n\n## Registries\n\n- [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.robhunter%2Fagentdeals/versions)\n- [Glama](https://glama.ai/mcp/connectors/io.github.robhunter/agentdeals)\n\n## License\n\nMIT\n",
  "bytes": 12376,
  "sha": "7bdad0bdc52e9929e19ab7d099ff9cae2205c838a875150d64cc77ffb5b07c88",
  "repo_slug": "robhunter/agentdeals",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_robhunter_agentdeals_78602f30/readme"
}