Step-by-step instructions to add AgentDeals as an MCP server in Claude Desktop, Claude Code, Cursor, VS Code, OpenCode, and Windsurf. Search 1,600+ developer deals from your AI assistant.

Setup Guide

Add AgentDeals to your AI coding assistant. 4 MCP tools for searching deals, comparing vendors, planning stacks, and tracking changes.

📦 One-Click Install

Install AgentDeals directly in Claude Desktop — no configuration needed.

Download .mcpb Extension View Release →

Download the .mcpb file and double-click to install in Claude Desktop. All 4 tools and 6 prompt templates are immediately available. No npx, no config editing, no restart.

Quick start

Claude Code: claude mcp add agentdeals -- npx -y agentdeals

npx (any client): npx -y agentdeals

Remote endpoint: https://agentdeals.dev/mcp

Client Setup

Choose your MCP client. Each supports local (npx) or remote (HTTP) transport.

Claude Desktop

Add to claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/ | Windows: %APPDATA%\Claude\

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

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

Claude Code

Run in your terminal, or add to .mcp.json in your project root

claude mcp add agentdeals -- npx -y agentdeals

Or add to .mcp.json:

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

claude mcp add agentdeals --transport http https://agentdeals.dev/mcp

Or add to .mcp.json:

{
  "mcpServers": {
    "agentdeals": {
      "type": "url",
      "url": "https://agentdeals.dev/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root

Or global: ~/.cursor/mcp.json

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

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

Cline (VS Code)

Add to cline_mcp_settings.json

Cline sidebar → MCP Servers → Configure

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

{
  "mcpServers": {
    "agentdeals": {
      "url": "https://agentdeals.dev/mcp",
      "transportType": "streamable-http"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

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

VS Code (Copilot)

Add to .vscode/mcp.json in your project root

Requires GitHub Copilot extension with MCP support enabled

{
  "servers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

{
  "servers": {
    "agentdeals": {
      "type": "http",
      "url": "https://agentdeals.dev/mcp"
    }
  }
}

OpenCode

Add to opencode.json in your project root

Or global: ~/.config/opencode/config.json

{
  "mcp": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

{
  "mcp": {
    "agentdeals": {
      "type": "remote",
      "url": "https://agentdeals.dev/mcp"
    }
  }
}

npm / npx

Run locally via npx — works with any MCP client that supports stdio transport

Requires Node.js 18+. Published as agentdeals on npm.

npx -y agentdeals

Or install globally:

npm install -g agentdeals
agentdeals

Generic MCP

Any MCP client that supports streamable-http transport

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

Endpoint: https://agentdeals.dev/mcp
Transport: streamable-http
Session: Mcp-Session-Id header (auto-managed)

What Can You Ask?

Once connected, try these prompts in your AI assistant — it picks the right AgentDeals tool automatically.

> Find free database hosting

Search 1,600+ deals by category, pricing, or keyword

search_deals

> Compare Supabase vs Neon

Side-by-side comparison of free tiers, risk levels, and limits

compare_vendors

> What pricing changes happened this month?

Track free tier removals, limit changes, and new deals

track_changes

> Estimate costs for a SaaS backend

Stack recommendations, cost estimates, and infrastructure audits

plan_stack

> Is Heroku's free tier at risk?

Risk scoring based on pricing history and signals

compare_vendors

> Show me startup credit programs

Filter by eligibility type: startup, student, or open-source

search_deals

> What are alternatives to Vercel?

Vendor details with alternatives in the same category

search_deals

> Audit my current stack: Vercel, Supabase, Clerk

Risk assessment, cost projection, and gap analysis for your stack

plan_stack

> Any deals expiring soon?

Upcoming expirations and deadlines across tracked vendors

track_changes

> What's new this week?

Recently added deals and pricing updates

search_deals

Use with Popular Frameworks

AgentDeals works with any MCP-compatible framework. Step-by-step integration guides:

LangChain
Python · langchain-mcp-adapters CrewAI
Python · native mcps field n8n
No-code · MCP Server Trigger Vercel AI SDK
TypeScript · createMCPClient()

Troubleshooting

Server not found / connection refused: For local (npx): ensure Node.js 18+ is installed. For remote: the endpoint is https://agentdeals.dev/mcp — include the /mcp path.
Session timeout: Remote sessions expire after 30 minutes of inactivity. Your client will automatically reconnect on the next request.
Tools not appearing: After adding the config, restart your MCP client. Tools appear after the MCP initialization handshake completes.
CORS errors (browser-based clients): The server sends Access-Control-Allow-Origin: * headers. If you see CORS errors, check that you're using the correct endpoint URL.

Prefer plain HTTP? Use the REST API — no MCP client needed, same data.