Getting Started with Handler
Handler gives your AI agents instant superpowers — web search, B2B data, financial markets, social monitoring, email, audio, marketing, and 200+ connectable services. All governed by your spending rules.
Quick Start
Get your agent key
Sign up at app.usehandler.dev/signup to get your agent key. It looks like sk-hndlr-xxx and identifies your agent across all Handler services.
Connect your agent via MCP
Add Handler as an MCP server in your agent's configuration. This works with Claude Code, Cursor, ChatGPT, and any MCP-compatible platform.
{
"mcpServers": {
"handler": {
"url": "https://mcp.usehandler.dev/mcp",
"headers": {
"Authorization": "Bearer sk-hndlr-YOUR_KEY"
}
}
}
}
Make your first call
Your agent can now call any Handler superpower. Try a web search:
handler_research({ "query": "AI agent frameworks 2026" })
Your First Response
Every Handler call returns a consistent response format with the result, cost breakdown, and remaining budget:
{
"status": "executed",
"result": {
"results": [...],
"query": "AI agent frameworks 2026"
},
"cost": {
"charged": 0.005,
"superpower": "handler_research",
"task": "search"
},
"budget": {
"remaining": 9.995,
"calls_remaining": 1999
}
}
The status field tells your agent what happened:
| Status | Meaning |
|---|---|
| executed | Call succeeded and the result is included in the response. |
| pending | Call is held for owner approval. The owner has been notified via their preferred channel. |
| blocked | Call was blocked because it exceeds a spending cap or governance rule. |
| auth_required | The required service is not connected yet. The owner needs to connect it in the dashboard. |
What's Next
Superpowers
Explore all 7 superpowers and their tasks — web search, B2B intel, finance, monitoring, and more.
Governance
Set spending rules, approval workflows, and per-superpower controls for every agent.
Connected Services
Connect your own Gmail, Slack, GitHub, and 200+ services for agents to use on your behalf.
Examples
Real-world agent workflows: lead research, market monitoring, automated outreach, and more.
Platform Guides
Step-by-step setup for Claude Code, Cursor, ChatGPT, OpenClaw, Paperclip, and other agents.