aegrid-mcp

MCP server for Aegrid — AI agents can shop products and discover AI services on your behalf.

Connects Claude Desktop, Claude Code, Cursor, and any MCP-compatible client to:

• Product shopping — agents find products, compare prices, and buy on your behalf (human approval required)
• AI service discovery — search 11,000+ APIs, models, and tools by capability, pricing, or keyword
• Price drop watchlist — monitor products and get alerts when prices fall

Every purchase requires explicit human approval — the agent generates a link; you click Approve.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "aegrid": {
      "command": "npx",
      "args": ["-y", "aegrid-mcp"],
      "env": {
        "AEGRID_API_KEY": "your_aegrid_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add aegrid -- npx -y aegrid-mcp
# Then set your API key:
# export AEGRID_API_KEY=your_key  (add to your shell profile)

Get an API Key

Sign up at aegrid.ai/register — free tier available.

Tools

Getting Started

| Tool | Description | |------|-------------| | aegrid_help | Learn what Aegrid offers and which tool to use. Call this first if you're unsure. |

Shopping & Commerce

| Tool | Description | |------|-------------| | search_products | Find products by keyword, price, category, or stock status | | get_spend_status | Check remaining daily budget and per-transaction limit | | create_order | Initiate a purchase (returns approval link — human must approve) | | get_order | Check approval, payment, and fulfillment status | | refresh_approval | Generate a new approval link for an expired order |

Price Drop Watchlist

| Tool | Description | |------|-------------| | create_watch | Watch a search query for price drops (max 20 active watches) | | get_alerts | Poll for unacknowledged price drop alerts — call every 4h on heartbeat | | ack_alert | Acknowledge an alert after presenting it to the human | | list_watches | Show the human what searches are being monitored | | delete_watch | Stop monitoring a search |

Service Discovery

| Tool | Description | |------|-------------| | search_services | Search 11,000+ AI APIs, models, and MCP servers by capability, pricing, or keyword |

How It Works

Buying a Product

1. Agent calls search_products — finds items with prices, images, and variant SKUs
2. Human picks an item
3. Agent collects shipping address + email, calls create_order
4. Agent shows the approval_url to the human: "Tap here to approve"
5. Human clicks — payment captured — merchant fulfills
6. Agent calls get_order to track fulfillment

Human approval is always required. The agent cannot complete a purchase without it.

Watching for Price Drops

1. Agent calls create_watch with a search query and optional target price
2. On its heartbeat (every 4h), agent calls get_alerts to check for new alerts
3. When an alert fires, agent presents it to the human and calls ack_alert with their outcome

Finding an AI Service

1. Agent calls search_services with a capability or natural language query
2. Results include agent_description (how to use the service), invocation_type, pricing, and a readiness score
3. Use has_api=true to filter to directly callable services only

Configuration

| Env var | Required | Description | |---------|----------|-------------| | AEGRID_API_KEY | Yes | Your Aegrid API key from aegrid.ai/register | | AEGRID_API_BASE_URL | No | Override API base (default: https://api.aegrid.ai) |

License

MIT