# HANDLER # usehandler.dev # machine-readable view # VERSION: 3.3 Handler — Identity & Governance for AI Agents. Every agent needs a handler. One profile per agent. Full control. --- ## WHAT HANDLER DOES Handler gives your agents an identity — an agent profile — with governed access to web search, B2B intelligence, financial data, social monitoring, audio, marketing analytics, AI inference, and 200+ connectable services. One profile per agent. Full control. --- ## HOW TO CONNECT MCP superpowers (all agents): https://mcp.usehandler.dev/mcp (13 tools — 7 superpowers + 6 utilities, plus N connected services) MCP management (admins/owners): https://mcp.usehandler.dev/manage (30 management tools) REST API: https://api.usehandler.dev/v2 Auth: Bearer sk-hndlr- on both MCP and REST Regular agents: connect to /mcp only. Admins/owners: connect to both /mcp and /manage. Capability changes on /manage are reflected immediately on the next tool call. ## IF YOU DO NOT HAVE A KEY Option 1 — Trial: POST https://api.usehandler.dev/v2/keys/trial Content-Type: application/json {"owner_email": "owner@yourdomain.com"} Response: {"key": "sk-hndlr-...", "balance_usd": 0.50, "calls_remaining": 100, "expires_at": "..."} Trial: $0.50 credit, 100 calls, 7-day TTL. No credit card. Option 2 — Full account (ask your owner): https://app.usehandler.dev/signup Owner sets spending rules, you get a persistent key. Docs for agents: https://usehandler.dev/docs/for-agents --- ## SUPERPOWERS (always available) ### handler_research — Web & Knowledge Research task: search (default) — semantic web search task: read — extract content from any URL task: answer — AI-powered answer with citations task: similar — find pages similar to a URL ### handler_intel — B2B & People Intelligence task: person_search (default) — find people by company, title task: person_enrich — enrich from email, name, or LinkedIn task: company_enrich — company data, funding, employee count task: query — natural language to structured search query ### handler_monitor — Social & News Monitoring task: news (default) — search recent news task: twitter — search tweets and discussions task: reddit — search Reddit posts (structured — scores, comments, subreddit, author) task: web — general web mentions task: trends — Google Trends data task: trending — multi-source social intelligence (Twitter + Reddit + HN + News + TikTok + Instagram, ranked) ### handler_finance — Financial Data & Analysis task: quote (default) — ticker details, market cap task: news — market news per ticker task: tickers — search ticker symbols task: dividends — dividend history task: indicators — technical indicators (SMA, EMA) task: crypto — crypto open/close prices task: market_status — US market open/closed ### handler_audio — Speech & Audio task: transcribe — audio to text task: speak (default) — text to speech task: summarize — transcribe + summarize task: topics — detect topics in audio ### handler_marketing — SEO & Marketing Intelligence task: serp (default) — Google search rankings task: trends — Google Trends data task: shopping — competitor pricing task: news — Google News results task: maps — local SEO results task: youtube — YouTube search ### handler_generate — AI Inference task: chat (default) — text generation via LLM task: moderate — content safety check Cost shown in every response. --- ## INTERNAL / BYOK SUPERPOWERS (visible when a relevant service is connected) handler_communicate email and messaging — Gmail, Slack, Outlook, Discord, Teams handler_dev development tools — GitHub, Linear, Jira, GitLab handler_docs document and knowledge — Notion, Google Docs, Confluence, Drive handler_crm customer relationships — HubSpot, Salesforce, Pipedrive handler_social social media — Twitter, LinkedIn, Instagram, YouTube handler_productivity tasks/calendars — Google Calendar, Todoist, Asana, Trello handler_support customer support — Zendesk, Intercom, Freshdesk handler_data data sources — Airtable, Google Sheets, databases handler_commerce e-commerce — Shopify, Stripe, Square handler_hr HR — employees, time-off, payroll 200+ services via OAuth. Connected-service calls: $0.50 per 1,000 calls. Owner-context tasks act as the owner. --- ## GOVERNANCE Org-wide spend gating, profile-level customization: monthly_org_cap hard ceiling on org's monthly spend (blocks at limit) dollar_balance prepaid balance — calls fail when it hits zero org_suspended kill switch — blocks all calls org-wide allowed_services which superpowers an agent profile can touch permission_defaults per-action policy (auto / approve / block) on the profile approval_routing where holds go (dashboard / WhatsApp / Telegram / email / MCP) Three-tier approval routing per profile: auto instant execution, audit only delegated master agent can approve via MCP owner_req admin/owner approves via configured channel Member RBAC (per-member capability flags): super_admin / admin: full org control member: capabilities granted explicitly (can_create_profiles, can_configure_approvals, …) viewer: read-only --- ## UTILITY TOOLS handler_status what you can do right now (capabilities, balance, rules) handler_connect browse 200+ services or connect one via OAuth handler_disconnect revoke a connected service handler_connections list connected + available services handler_skills browse multi-step workflow recipes filtered to your profile handler_check poll a pending approval --- ## MANAGEMENT API (Admin / Master Agent) Auth: agent key with management capabilities granted by the org admin/owner. Admin login: handler login Spending & rules: handler_manage_status() handler_agents() — list profiles with rules and monthly spend handler_agent_detail(agent_id) handler_create_agent(name, ...) — returns key once handler_update_rules(agent_id, ...) handler_deactivate_agent(agent_id, active) handler_toggle_service(agent_id, service, enabled) handler_pin_service(agent_id, service, require_owner) handler_update_approval_routing(agent_id, channels) Approvals & activity: handler_approvals(tier?, agent_id?, limit?) handler_decide(approval_id, decision, reason?) handler_activity(agent_id?, limit?, outcome?, since?) handler_spend_summary(period?, agent_id?) handler_effective_permissions(agent_id?) Members & groups: handler_manage_members(task: list|update|deactivate, ...) handler_invite_member(email, role?, display_name?) handler_manage_groups(task: list|create|update|delete, ...) handler_assign_profile_to_group(agent_id, group_id) handler_unassign_profile_from_group(agent_id, group_id) Templates & policies: handler_manage_templates(task: list|create|update|delete, ...) handler_manage_approval_policies(task: list|create|update|delete, ...) Discovery & IdP: handler_catalog(category?, search?) handler_idp_status() / handler_idp_sync_now() --- ## PRICING Plan: $15/month - $15 USD allowance included - Profile instance: $2/month per active member - Superpowers: priced per call, cost shown in every response - Connected services: $0.50 per 1,000 calls - Overage: pay as you go, same rates Enterprise: Custom pricing, SSO/IdP, SLA, volume rates. --- ## LINKS Signup: https://usehandler.dev/signup Superpowers: GET https://api.usehandler.dev/v2/superpowers Claude skill: https://usehandler.dev/skills/claude.md Cursor skill: https://usehandler.dev/skills/cursor.mdc Metadata: https://usehandler.dev/.well-known/handler.json MCP server: https://mcp.usehandler.dev/mcp # end