About agentswitchboard
Agent Switchboard is a curated, verified directory of AI agents, MCP servers, and agentic tools. Its catalog can be searched through a website, REST API, or MCP interface.
Key features
- 01Curated agent and tool catalog
- 02Monthly verification of listings
- 03Search, detail, and category queries
- 04REST API and catalog JSON
- 05Git-based content management
Use cases
- 01Find agents by capability or access type
- 02Retrieve listing details programmatically
- 03Browse catalog categories
- 04Maintain and validate directory entries
MCP support
Exposes the catalog through Streamable HTTP tools: `search_agents`, `get_agent`, and `list_categories`. MCP clients can connect without authentication.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://agentswitchboard.dev/api/mcpclaude mcp add --transport http assafbar2-agentswitchboard https://agentswitchboard.dev/api/mcp{"mcpServers":{"assafbar2-agentswitchboard":{"type":"http","url":"https://agentswitchboard.dev/api/mcp"}}}Open in Cursor{"servers":{"assafbar2-agentswitchboard":{"type":"http","url":"https://agentswitchboard.dev/api/mcp"}}}Open in VS Code{"mcpServers":{"assafbar2-agentswitchboard":{"type":"http","url":"https://agentswitchboard.dev/api/mcp"}}}{"mcpServers":{"assafbar2-agentswitchboard":{"serverUrl":"https://agentswitchboard.dev/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Max results per page (1–50) |
| query | string | No | Free-text search (name, description, skills, tags) |
| access | array | No | Require ALL of these access methods (api, mcp, cli, browser-extension) |
| offset | integer | No | Number of results to skip, for pagination |
| category | string | No | Category slug, e.g. "code-devtools", "voice-messaging" |
| official | boolean | No | Only first-party listings from major vendors (e.g. Notion's own Notion MCP) |
Details
From the project READMEAgent Switchboard
The curated directory for the agentic web — AI agents, MCP servers, and agentic tools with real API, MCP, CLI, or browser-extension access. Live at agentswitchboard.dev.
A listing marked Verified is one we checked works: its URLs load and its declared access (API, MCP, CLI or extension) responds. Re-checked monthly; the label drops if it stops working.
🔌 This directory is itself an MCP server
Point any MCP client at it and query the catalog with native tools:
{
"mcpServers": {
"agentswitchboard": { "url": "https://agentswitchboard.dev/api/mcp" }
}
}
Tools: search_agents · get_agent · list_categories. Streamable HTTP, no
auth. Stdio-only clients: npx -y mcp-remote https://agentswitchboard.dev/api/mcp
Prefer plain HTTP? There's a REST search too:
curl "https://agentswitchboard.dev/api/agents?q=video&access=mcp&limit=5"
curl "https://agentswitchboard.dev/api/agents/agentmail"
curl "https://agentswitchboard.dev/api/categories"
OpenAPI: /openapi.json.
Connector skill: /skill.md.
Also machine-readable: /agents.json
(full catalog, CORS-open), in-browser tools via WebMCP (document.modelContext),
and an agent-optimized view on every page (the "For Agents" toggle).
Full API reference: docs/API.md — REST search/detail/categories, MCP, WebMCP, and the catalog dump.
🗂 Git-as-CMS
The entire catalog lives in this repo:
content/
agents/<slug>.json one file per agent — the source of truth
categories.json category definitions
changelog.json public audit log (rendered at /changelog)
There is no database and no CMS. Editing content = editing files. Merging to
main = publishing. Every entry is schema-validated in CI
(scripts/validate-content.ts) — a bad entry
cannot merge. A weekly job link-checks every listing's agent and provider URLs.
Want to add or fix a listing? See CONTRIBUTING.md. Non-developers: agentswitchboard.dev/submit.
Development
npm install
npm run dev # no env vars needed — content is right here
| Command | |
|---|---|
npm run dev | dev server |
npm run build | production build (SSG, all pages) |
npm test | unit tests |
npm run lint / npm run typecheck | quality gates |
npx tsx scripts/validate-content.ts | validate the catalog |
npx tsx scripts/check-links.ts | link-rot sweep |
npx tsx scripts/cms.ts | content ops: find / feature / update / unpublish |
npx tsx scripts/weekly-drop.ts | batch-add agents (see file header) |
Stack: Next.js (App Router) · Tailwind · file-based catalog · deployed on Vercel.
License
- Code (
app/,components/,lib/,scripts/, config) — MIT - Catalog data (
content/) — CC BY-NC 4.0: reuse for non-commercial purposes with attribution to Agent Switchboard; contact us for commercial use. (Versions up to 2026-09-25 remain CC-BY-4.0.)
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.