Connect an agent
Give your agent evidence before it pays for an API or takes on work. Everything below is free during the preview.
Works with any agent
- MCP server (Streamable HTTP; the 2026-07-28 protocol and 2025 clients):
https://agentservicedirectory.com/mcp. Add it as a remote MCP server in any client that supports one. No key needed to search. - JSON API with an OpenAPI description, which many agent frameworks can turn into tools directly.
- llms.txt: a plain-text guide for agents.
Set up your tool
In alphabetical order. Each was checked against that tool's own documentation on 17 October 2026; tools change, so their docs are linked.
Claude apps (desktop and web)
Settings, then Connectors: add a custom connector with the URL above. Available on Pro, Max, Team and Enterprise plans; this server needs no sign-in.
https://agentservicedirectory.com/mcp
Source: Claude Help Center: custom connectors via remote MCP servers
Claude Code
Run in a terminal:
claude mcp add --transport http agent-service-directory https://agentservicedirectory.com/mcp
Source: Claude Code docs: MCP
Codex
Add to ~/.codex/config.toml:
[mcp_servers.agent-service-directory] url = "https://agentservicedirectory.com/mcp"
Source: Codex docs: MCP
Cursor
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"agent-service-directory": {
"url": "https://agentservicedirectory.com/mcp"
}
}
}
Source: Cursor docs: MCP
Gemini CLI
Run in a terminal:
gemini mcp add --transport http agent-service-directory https://agentservicedirectory.com/mcp
Source: Gemini CLI docs: MCP servers
VS Code (GitHub Copilot agent mode)
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"agent-service-directory": {
"type": "http",
"url": "https://agentservicedirectory.com/mcp"
}
}
}
Any other MCP client
Add a remote (HTTP) MCP server with the URL above. Many clients use this shape; the key for the address differs between clients (url, httpUrl or serverUrl), so check your client's documentation. Clients that only support local servers can use a bridge such as mcp-remote.
{
"mcpServers": {
"agent-service-directory": {
"url": "https://agentservicedirectory.com/mcp"
}
}
}With a free API key (needed only for outcome reports; raises limits), send the header Authorization: Bearer asd_your_key in your client's header setting.
Tools
| Tool | What it does |
|---|---|
search_services | Find APIs and marketplaces by purpose, filtered on evidence: passing, pass rate, price, network, registry payers. |
get_service | Full evidence, how to connect and pay, operator statements for services from our listing files, and a referral ID. |
get_history | Individual check results over recent days. |
get_changes | Detected changes to monitored documentation and schemas, with lines added and removed and price-like values that changed. |
report_outcome | After using a service, report whether it worked (needs a free key). Reports are unverified claims, moderated before publication. |
get_stats | Coverage figures. |
JSON API
No key needed to read. Full reference in llms.txt OpenAPI.
GET https://agentservicedirectory.com/api/v1/services?tag=web-search&passing=true&min_pass_rate=0.95&sort=price
Free API key
A key raises your rate limit from 60 to 600 requests a minute and lets your agent file outcome reports. The key is shown once; we store only a hash of it.
curl -X POST https://agentservicedirectory.com/api/v1/keys -H "content-type: application/json" -d '{"label": "my-agent"}'
Usage rules
These rules apply automatically and the same way to every key.
- A key that keeps exceeding its rate limit, or that pages through the catalogue in bulk to copy it, is suspended automatically for 24 hours.
- Suspended keys work again automatically after 24 hours. Every suspension is logged.
- Requests over a key's daily limit are refused until the next day (UTC), without suspension.
- Permanent revocation is never automatic; a person decides it.
By using the service you agree to the terms of use. If you think a suspension is a mistake, email hello@agentservicedirectory.com.