robhunter/agentdeals

ملف robhunter

آخر نشاط مصدر مسجل: ١٣ أكتوبر ٢٠٢٦ في ١٤:٢٤

آخر تحديث لفهرس SkillsMP: ٢٦ أكتوبر ٢٠٢٦ في ١١:٣٧

skills مجمعة: ٣

نجوم GitHub: ٢٣
تفرعات GitHub: ٤

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# AgentDeals [![npm version](https://img.shields.io/npm/v/agentdeals.svg)](https://www.npmjs.com/package/agentdeals) [![npm downloads](https://img.shields.io/npm/dm/agentdeals.svg)](https://www.npmjs.com/package/agentdeals) An 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. AgentDeals indexes pricing data from 1,400+ developer infrastructure vendors across 60 categories. Every entry carries the day we last read the vendor's own page, and how many of them a read confirmed inside the last 90 days is measured on the catalogue rather than asserted here — [agentdeals.dev/api/freshness](https://agentdeals.dev/api/freshness) publishes that count, and every listing page states it over the set it lists. 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. **Live:** [agentdeals.dev](https://agentdeals.dev) **Free tiers for AI and LLM APIs:** [a dated, sourced list of 31 vendors](artifacts/free-llm-api-index/README.md), regenerated from the catalogue whenever a record moves. Every row carries the date we last read that vendor's own page and the URL we read it on, and the rows whose terms changed carry the terms they replaced. ## Install ### Option A: Claude Code Plugin (one-click) Install AgentDeals in Claude Code with a single command: ```bash claude plugin install robhunter/agentdeals ``` This auto-configures the remote MCP server — no local setup needed. All 4 tools and 6 prompt templates are immediately available. ### Option B: Claude Desktop Extension (one-click) Install AgentDeals directly in Claude Desktop — no configuration needed: 1. Download the latest `agentdeals.mcpb` from [Releases](https://github.com/robhunter/agentdeals/releases) 2. Double-click the file to install in Claude Desktop 3. All 4 tools and 6 prompt templates are immediately available Or browse for AgentDeals in Claude Desktop under **Settings > Extensions**. ### Option C: npx (local stdio) No server needed. Runs locally via stdin/stdout: ```json { "mcpServers": { "agentdeals": { "command": "npx", "args": ["-y", "agentdeals"] } } } ``` ### Option D: Remote HTTP Connect to the hosted instance — no install required: ```json { "mcpServers": { "agentdeals": { "url": "https://agentdeals.dev/mcp" } } } ``` ### Quick Setup (.mcp.json) Add AgentDeals to any project by dropping this `.mcp.json` in the project root: ```json { "mcpServers": { "agentdeals": { "url": "https://agentdeals.dev/mcp" } } } ``` This works with Claude Code, Cursor, and other MCP-compatible clients that read `.mcp.json`. ## Quick Start ### Try these example queries **Find free database hosting:** ``` Use the search_deals tool: query: "database" category: "Databases" ``` Returns Neon (0.5 GiB free Postgres), Supabase (500 MB), MongoDB Atlas (512 MB shared cluster), PlanetScale alternatives, and more. **What pricing changes happened recently?** ``` Use the track_changes tool (no params for weekly digest, or filter): since: "2025-01-01" ``` Returns tracked changes like PlanetScale free tier removal, Heroku free dynos sunset, Render pricing restructure, and other shifts. **Show deals I qualify for as a YC company:** ``` Use the search_deals tool: eligibility: "accelerator" ``` Returns AWS Activate, Google Cloud for Startups, Microsoft Founders Hub, Stripe Atlas credits, and 150+ other startup program deals. ## Client Configuration Each client supports both **local stdio** (via npx) and **remote HTTP**. Stdio is recommended for reliability and speed. ### Claude Desktop Add to `claude_desktop_config.json`: **Stdio (recommended):** ```json { "mcpServers": { "agentdeals": { "command": "npx", "args": ["-y", "agentdeals"] } } } ``` **Remote HTTP:** ```json { "mcpServers": { "agentdeals": { "url": "https://agentdeals.dev/mcp" } } } ``` Config location: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` ### Cursor Add to `.cursor/mcp.json` in your project or global config: **Stdio (recommended):** ```json { "mcpServers": { "agentdeals": { "command": "npx", "args": ["-y", "agentdeals"] } } } ``` **Remote HTTP:** ```json { "mcpServers": { "agentdeals": { "url": "https://agentdeals.dev/mcp" } } } ``` ### VS Code (GitHub Copilot) Add to `.vscode/mcp.json` in your workspace: **Stdio (recommended):** ```json { "servers": { "agentdeals": { "type": "stdio", "command": "npx", "args": ["-y", "agentdeals"] } } } ``` **Remote HTTP:** ```json { "servers": { "agentdeals": { "type": "http", "url": "https://agentdeals.dev/mcp" } } } ``` ### Claude Code Add to `.mcp.json` in your project root: **Stdio (recommended):** ```json { "mcpServers": { "agentdeals": { "command": "npx", "args": ["-y", "agentdeals"] } } } ``` **Remote HTTP:** ```json { "mcpServers": { "agentdeals": { "type": "url", "url": "https://agentdeals.dev/mcp" } } } ``` ## REST API AgentDeals also provides a REST API for programmatic access without MCP. ### Search offers ```bash # Search by keyword curl "https://agentdeals.dev/api/offers?q=database&limit=5" # Filter by category curl "https://agentdeals.dev/api/offers?category=Databases&limit=10" # Paginate results curl "https://agentdeals.dev/api/offers?limit=20&offset=40" # Combine search + category curl "https://agentdeals.dev/api/offers?q=postgres&category=Databases" ``` Response: ```json { "offers": [ { "vendor": "Neon", "category": "Databases", "description": "Serverless Postgres with 0.5 GiB storage, 100 CU-hours/month compute on free tier", "tier": "Free", "url": "https://neon.com/pricing", "tags": ["database", "postgres", "serverless"] } ], "total": 142 } ``` ### List categories ```bash curl "https://agentdeals.dev/api/categories" ``` Response: ```json { "categories": [ { "name": "Cloud Hosting", "count": 45 }, { "name": "Databases", "count": 38 }, { "name": "Developer Tools", "count": 414 } ] } ``` ### More endpoints ```bash # Recently added offers curl "https://agentdeals.dev/api/new?days=7" # Pricing changes curl "https://agentdeals.dev/api/changes?since=2025-01-01" # Vendor details curl "https://agentdeals.dev/api/details/Supabase?alternatives=true" # Stack recommendation curl "https://agentdeals.dev/api/stack?use_case=saas" # Check free tier coverage per service curl "https://agentdeals.dev/api/costs?services=Vercel,Supabase" # Compare vendors curl "https://agentdeals.dev/api/compare?a=Supabase&b=Neon" # Vendor risk check curl "https://agentdeals.dev/api/vendor-risk/Heroku" # Stack audit curl "https://agentdeals.dev/api/audit-stack?services=Vercel,Supabase,Clerk" # Server stats curl "https://agentdeals.dev/api/stats" # Traffic attributed by client class (AI agent / crawler / browser), and web vs MCP curl "https://agentdeals.dev/api/traffic" # OpenAPI spec curl "https://agentdeals.dev/api/openapi.json" ``` ## Available Tools | Tool | Description | |------|-------------| | `search_deals` | Find free tiers, browse categories, get vendor details with alternatives. Filter by category, eligibility, or keyword. | | `plan_stack` | Get stack recommendations, free-tier checks, or a full infrastructure audit for your project. | | `compare_vendors` | Compare 2 vendors side-by-side or check a single vendor's pricing risk. | | `track_changes` | Track pricing changes, upcoming expirations, and new deals. Weekly digest with no params. | | `get_referral_code` | Look up the referral link we hold for a vendor, with the conditions attached to it. We hold codes for a handful of vendors. | ### search_deals **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` (string, optional) — Filter: `public`, `accelerator`, `oss`, `student`, `fintech`, `geographic`, `enterprise` - `sort` (string, optional) — Sort: `vendor` (A-Z), `category`, `newest` (newest catalogue date first) - `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 ### plan_stack **Parameters:** - `mode` (string, required) — `recommend`, `estimate`, or `audit` - `use_case` (string, optional) — What you're building (for recommend mode) - `services` (array, optional) — Current vendor names (for estimate/audit mode) - `scale` (string, optional) — `hobby`, `startup`, `growth` (for estimate mode, default: hobby) - `requirements` (array, optional) — Specific infra needs (for recommend mode) ### compare_vendors **Parameters:** - `vendors` (array, 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 **Parameters:** - `since` (string, optional) — ISO date. Default: 7 days ago. - `change_type` (string, optional) — Filter: `free_tier_removed`, `limits_reduced`, `limits_increased`, `new_free_tier`, `pricing_restructured`, etc. - `vendor` (string, optional) — Filter to one vendor - `vendors` (string, optional) — Comma-separated vendor names to filter - `include_expiring` (boolean, optional) — Include upcoming expirations (default: true) - `lookahead_days` (number, optional) — Days to look ahead for expirations (default: 30) ### get_referral_code **Parameters:** - `vendor` (string, required) — Vendor name to get the referral code for (e.g. `'Railway'`) ## Use Cases ### Agent-assisted infrastructure selection When your AI agent recommends infrastructure, it's usually working from training data — not current pricing. By connecting AgentDeals, the agent can: 1. **Compare free tiers**: "I'm evaluating Supabase vs Neon for a side project" — use `compare_vendors` with both names 2. **Check eligibility**: "We're a YC W24 company, what credits can we get?" — use `search_deals` with `eligibility: "accelerator"` 3. **Verify before recommending**: Use `track_changes` to ensure the free tier hasn't been removed or reduced ### Monitoring deal changes Track pricing shifts that affect your stack: 1. **Weekly digest**: Call `track_changes` with no params for a curated summary 2. **Filter by vendor**: Call `track_changes` with `vendor: "Vercel"` to see if Vercel's pricing has changed 3. **Filter by type**: Call `track_changes` with `change_type: "free_tier_removed"` to see which vendors have eliminated free tiers ## Categories AI / 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 ## Development ```bash npm install # Install dependencies npm run build # Compile TypeScript npm test # Run tests (266 passing) npm run serve # Run HTTP server (port 3000) npm start # Run stdio server ``` ### Local development with stdio ```bash npm start ``` ### Local development with HTTP ```bash npm run serve # Server starts at http://localhost:3000 # MCP endpoint: http://localhost:3000/mcp # Landing page: http://localhost:3000/ ``` ### Environment Variables | Variable | Description | Default | |----------|-------------|---------| | `PORT` | HTTP server port | `3000` | | `BASE_URL` | Base URL for canonical links, OG tags, sitemaps, and feeds | `https://agentdeals.dev` | | `GOOGLE_SITE_VERIFICATION` | Google Search Console verification code | _(none)_ | ## Stats Every figure we publish about the catalogue is measured on it, so this section links the measure rather than restating it — a number typed here is a second copy, and a second copy drifts. - Catalogue size, categories, and how many entries a read confirmed inside the last 90 days — [/api/freshness](https://agentdeals.dev/api/freshness) - Tracked pricing changes — [/api/changes](https://agentdeals.dev/api/changes) - MCP tools, prompt templates, and REST endpoints — [/setup](https://agentdeals.dev/setup) and [/llms.txt](https://agentdeals.dev/llms.txt) ## Registries - [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.robhunter%2Fagentdeals/versions) - [Glama](https://glama.ai/mcp/connectors/io.github.robhunter/agentdeals) ## License MIT

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

محللو أبحاث السوق ومتخصصو التسويق مندوبو مبيعات الخدمات (باستثناء الإعلان والتأمين والخدمات المالية والسياحة)

٢ فئات مهنية · 67% مصنفة

skill

المهنة

الوصف

آخر تحديث

agentdeals

غير مصنف

Search and compare 1,400+ developer infrastructure deals — free tiers, startup credits, and pricing changes across 54 categories.

لغة النص الأصلي: الإنجليزية

2026-10-13

check-pricing-changes

محللو أبحاث السوق ومتخصصو التسويق

Check recent developer tool pricing changes, free tier removals, and new deals

لغة النص الأصلي: الإنجليزية

2026-03-17

search-deals

مندوبو مبيعات الخدمات (باستثناء الإعلان والتأمين والخدمات المالية والسياحة)

Search for free tiers, startup credits, and developer tool deals

لغة النص الأصلي: الإنجليزية

2026-03-17

عرض ٣ من أصل ٣ skills مجمعة.

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/robhunter/agentdeals.