# agent101-mcp

MCP server for [agent101](https://agent101.ventify.ai) — an open directory of 500+ tools, APIs, and services for AI agents.

## What it does

Gives any MCP-compatible agent (Claude, GPT, Cursor, etc.) access to agent101's tool directory. Agents can search, browse, and get recommendations for the right tool for any task.

## Tools

| Tool | Description |
|------|-------------|
| `search_tools` | Search 500+ tools by keyword |
| `list_categories` | List all 15 categories with descriptions |
| `get_category` | Get all tools in a specific category |
| `recommend` | Get tool recommendations for a task description |

## Quick Start

### Using npx (recommended)

```json
{
  "mcpServers": {
    "agent101": {
      "command": "npx",
      "args": ["-y", "agent101-mcp"]
    }
  }
}
```

### Using Docker

```bash
docker build -t agent101-mcp .
docker run -p 3101:3101 agent101-mcp
```

### Manual

```bash
git clone https://github.com/rachelsu-blip/agent101-mcp.git
cd agent101-mcp
pip install -r requirements.txt
python server.py
```

## How it works

The server fetches tool listings from `agent101.ventify.ai` at startup and caches them. Each tool entry includes structured metadata:

- `url` — API endpoint
- `auth` — none / api_key / oauth / token
- `free_tier` — what's free
- `actions` — supported operations
- `input` / `output` — data formats
- `when_to_use` / `when_not_to_use` — decision guidance
- `example_call` — copy-paste ready

## Categories

| Category | Path | Tools |
|----------|------|-------|
| Find Information | /search/ | Tavily, Exa, Jina Reader, Firecrawl |
| Write & Run Code | /code/ | E2B, Modal, GitHub, Docker |
| Send Messages | /communication/ | Resend, Twilio, Slack, Telegram |
| Store Data | /data/ | Pinecone, Supabase, Upstash |
| AI Models | /ai-services/ | Anthropic, OpenAI, Groq, DeepSeek |
| Browse Web | /browser/ | Browser Use, Browserbase, Playwright |
| Payments | /payments/ | Stripe, Coinbase AgentKit, x402 |
| Files & Docs | /files/ | S3, R2, Unstructured, Veryfi |
| Social Media | /social/ | Twitter, Postiz, TikHub |
| People & Companies | /people/ | Hunter.io, Apollo, Clearbit |
| Real-Time Data | /realtime/ | NewsAPI, yfinance, Open-Meteo |
| Apps & Services | /apps/ | Notion, HubSpot, Linear, Shopify |
| Identity & Auth | /auth/ | Composio, Nango, Auth0 |
| Maps & Location | /maps/ | Google Maps, Nominatim, Overpass |
| Memory & Orchestration | /memory/ | Mem0, LangGraph, n8n, Dify |

## Links

- **Directory:** https://agent101.ventify.ai
- **API:** https://agent101.ventify.ai/api/search?q={query}
- **Skill file:** https://agent101.ventify.ai/skill.md

## License

MIT