{"service":"handler","version":"2.0","description":"Identity and governance layer for AI agents. One profile per agent — superpowers, connected services, permissions, and audit.","auth":"Authorization: Bearer <key>","trial_key":"POST /v2/keys/trial  {\"email\":\"you@example.com\"}","rest_api":"POST /v2/superpowers/{superpower}  with Authorization + Content-Type: application/json","mcp":"https://mcp.usehandler.dev/mcp  (requires MCP client library — use REST API for programmatic access)","superpowers":{"handler_research":"Web search, full page extraction, AI-synthesized answers with citations","handler_intel":"B2B people & company data — find by name/company, enrich from LinkedIn/email/domain","handler_monitor":"Social intelligence — Reddit (structured posts with scores/comments), HN, TikTok, Instagram, news. Use task:\"trending\" for all sources at once","handler_finance":"Stock quotes, crypto prices, SEC filings, technical indicators","handler_audio":"Audio transcription, text-to-speech, topic detection","handler_marketing":"Google SERP, Google Trends, competitor pricing, maps, YouTube search","handler_generate":"AI text generation and content moderation"},"connected_services":"Owners connect their own accounts (Gmail, GitHub, HubSpot, Notion, etc.) via OAuth. Each connected service appears as its own endpoint: POST /v2/superpowers/gmail { \"action\": \"GMAIL_SEND_EMAIL\", ...params }. GET /v2/agent/status to see your connected services and their full action catalogues.","example":{"request":"POST https://api.usehandler.dev/v2/superpowers/handler_research","headers":{"Authorization":"Bearer sk-hndlr-...","Content-Type":"application/json"},"body":{"task":"search","query":"latest funding rounds in AI infrastructure"}},"short_names_accepted":"research, intel, monitor, finance, audio, marketing, generate","discovery":{"spec":"GET https://api.usehandler.dev/llms.txt","your_capabilities":"GET https://api.usehandler.dev/v2/agent/status  (requires key — shows superpowers, connected services with full action catalogues, budget, and skills)","skills":"GET https://api.usehandler.dev/v2/skills  (requires key — workflow recipes showing how to chain superpowers; filtered by your capabilities)","superpower_schema":"GET https://api.usehandler.dev/v2/superpowers/{slug}  (full params + examples per task)","all_superpowers":"GET https://api.usehandler.dev/v2/superpowers  (requires key)","connection_catalog":"GET https://api.usehandler.dev/v2/connections/catalog  (all connectable services)","idp_status":"GET https://api.usehandler.dev/v2/idp/status  (requires admin key — Google Workspace sync state, recent runs, user/group counts)"},"management_api":"GET|POST|PATCH|DELETE https://api.usehandler.dev/v2/manage/* — operational management surface (parity with MCP /manage). Requires sk-member-* key. In scope: profiles, instances, members, groups, approval routing/policies, templates, action permissions, connection disconnect, IdP status+sync, catalog, activity, spend. Out of scope: billing, IdP setup, org suspend/resume, member removal — those stay dashboard-admin only.","identity_provider":"Org admins can connect Google Workspace at https://app.usehandler.dev/settings/identity. Users + groups mirror every 5 minutes. Promote discovered users to billable members; assign agent profiles to mirrored groups for cascading instance provisioning."}