# ToolRoute

> The OpenRouter for Tools -- one unified API to access 87+ best-in-class tools for AI agents.

ToolRoute is an MCP gateway that lets AI agents execute tools through a single API endpoint. Instead of managing separate API keys, authentication flows, and billing accounts for each tool, agents authenticate once and access everything.

## Key Facts
- 87 tools across 14 categories (AI/LLM, search, email, voice, database, security, video, image, content, business, social, code, productivity, SMS)
- 51 API adapters with 152+ operations
- 5 protocols: REST, MCP Streamable HTTP, A2A (Google), OpenAI Functions, SDKs
- Prepaid credits billing with auto-top-up
- BYOK (bring-your-own-key) support for 36 adapters
- Free tier: 100 requests/day, $1 starter credits

## Quick Start

```bash
curl -X POST https://toolroute.ai/api/v1/execute \
  -H "Authorization: Bearer tr_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tool": "firecrawl/scrape", "input": {"url": "https://example.com"}}'
```

## Core API Endpoints
- POST /api/v1/execute -- Execute any tool (tool ID format: provider/operation)
- POST /mcp -- MCP Streamable HTTP (JSON-RPC)
- POST /api/a2a -- A2A protocol (Google)
- GET /api/v1/tools -- Tool catalog (no auth required, supports ?format=openai)
- GET /api/v1/key -- API key info + balance
- POST /api/v1/checkout -- Add credits via Stripe
- POST /api/v1/byok -- Register your own API key for a provider

## Auto-Routing
Describe your task in natural language:
- `toolroute/check_before_build` -- Search only, returns matching tools ranked by confidence
- `auto/route` -- Search + execute in one call

## Pricing
- Free: $0/mo, 100 req/day, 10 RPM, 2 API keys
- Pro: $29/mo, 10K req/mo, 60 RPM, all tools, BYOK support
- Enterprise: $299/mo, 100K req/mo, 300 RPM, custom adapters, SLA

## Links
- Documentation: https://toolroute.ai/docs
- Tool catalog: https://toolroute.ai/tools
- Skills catalog: https://toolroute.ai/skills
- Pricing: https://toolroute.ai/pricing
- Blog: https://toolroute.ai/blog
- Full API reference: https://toolroute.ai/llms-full.txt
- OpenAPI spec: https://toolroute.ai/openapi.json
- GitHub: https://github.com/Instabidsai/toolroute