Add it to Claude Code
claude mcp add -e "API_KEY=${API_KEY}" agent-toolbox -- agent-toolbox-mcpAPI_KEYMake your agent remember this setup
agent-toolbox's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Unified API access for 13 different services with a single key
- Consistent JSON response formats across all tools
- Built-in rate limiting and smart LRU caching
- Supports web search, content extraction, and media generation
- Includes utility tools like DNS, WHOIS, and email validation
Tools 13
searchPerform web searches via DuckDuckGoextractExtract content from any URLscreenshotCapture webpage screenshotsweatherGet weather and forecast informationfinanceGet stock quotes and exchange ratesvalidate-emailValidate email addresses via MX and SMTPtranslateTranslate text across 100+ languagesgeoipPerform IP geolocation lookupnewsSearch for news articleswhoisPerform domain WHOIS lookupdnsQuery DNS recordspdf-extractExtract text from PDF documentsqrGenerate QR codesEnvironment Variables
API_KEYrequiredAPI key obtained from toolboxlite.comTry it
Original README from Vincentwei1021/agent-toolbox
⚡ Agent Toolbox
13 production-ready tools for AI agents — one API key, zero complexity.
Docs · Playground · OpenAPI Spec · npm
Why Agent Toolbox?
Building AI agents that interact with the real world? You'd normally need:
| Without Agent Toolbox | With Agent Toolbox |
|---|---|
| 6+ API keys (Google, OpenWeatherMap, Yahoo Finance, ...) | 1 API key |
| Different auth methods per service | Unified Bearer auth |
| Parse different response formats | Consistent JSON responses |
| Handle rate limits per provider | Built-in rate limiting |
| No caching, redundant calls | Smart LRU caching |
| Pay $50-200+/mo for APIs | Free tier: 1,000 calls/mo |
Quick Start (30 seconds)
1. Get your free API key
curl -X POST https://api.toolboxlite.com/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'
2. Make your first call
curl -X POST https://api.toolboxlite.com/v1/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "best AI agent frameworks"}'
3. That's it! 🎉
No credit card. No setup. 13 endpoints ready to use.
13 Endpoints
| Endpoint | Description | Cache |
|---|---|---|
POST /v1/search |
Web search via DuckDuckGo | 5 min |
POST /v1/extract |
Extract content from any URL | 5 min |
POST /v1/screenshot |
Capture webpage screenshots | 1 hr |
POST /v1/weather |
Weather & forecast | 15 min |
POST /v1/finance |
Stock quotes & exchange rates | 15 min |
POST /v1/validate-email |
Email validation (MX + SMTP) | 1 hr |
POST /v1/translate |
Translate 100+ languages | 1 hr |
POST /v1/geoip |
IP geolocation lookup | 1 hr |
POST /v1/news |
News article search | 5 min |
POST /v1/whois |
Domain WHOIS lookup | 1 hr |
POST /v1/dns |
DNS record queries | 5 min |
POST /v1/pdf-extract |
Extract text from PDFs | 1 hr |
POST /v1/qr |
Generate QR codes | 24 hr |
MCP Server
Use Agent Toolbox as an MCP server in Claude Desktop, Cursor, or Windsurf:
npm install -g agent-toolbox-mcp
Add to Claude Desktop config:
{
"mcpServers": {
"agent-toolbox": {
"command": "agent-toolbox-mcp"
}
}
}
See MCP Quickstart Guide for full setup instructions.
SDK Integrations
Python — LangChain
pip install langchain-agent-toolbox
from langchain_agent_toolbox import AgentToolboxSearchTool
search = AgentToolboxSearchTool()
result = search.invoke({"query": "AI agents", "count": 3})
Python — LlamaIndex
pip install llamaindex-agent-toolbox
from llamaindex_agent_toolbox import AgentToolboxSearchTool
search = AgentToolboxSearchTool()
result = search.call(query="AI agents", count=3)
Examples
| Example | Description |
|---|---|
| Research Agent | Auto-research any topic → markdown report |
| Website Monitor | Monitor sites with DNS + screenshots + content |
| MCP Quickstart | Claude Desktop / Cursor / Windsurf setup |
Pricing
| Plan | Price | Calls/month | Rate Limit |
|---|---|---|---|
| Free | $0 | 1,000 | 60/min |
| Pro | $29/mo | 50,000 | 120/min |
| Scale | $99/mo | 500,000 | 300/min |
All plans include all 13 endpoints. No feature gating.
Self-Hosting
git clone https://github.com/Vincentwei1021/agent-toolbox.git
cd agent-toolbox
npm install && npm run build
cp .env.example .env # Add your config
npm start
Or with Docker:
docker build -t agent-toolbox .
docker run -p 3100:3100 --env-file .env agent-toolbox
Used By
Building with Agent Toolbox? Open an issue to get listed here.
License
MIT © Vincentwei1021