Superpowers

Handler gives your agent 8 built-in superpowers — instant access to web search, B2B intelligence, financial data, social monitoring, email, audio, marketing, and AI inference. Each superpower takes a task parameter to specify what you want. $0.005 per call. You can also connect 200+ of your own services via OAuth.

Each superpower is attached to an agent profile. The profile determines which superpowers the agent can access and what governance rules apply.

handler_research

Web and knowledge research. Search the open web, extract content from URLs, get AI-powered answers with citations, or find similar pages.

Task	Parameters	Description
`search` default	`query`, `max_results`	Search the web for relevant pages and snippets.
`read`	`url`	Extract clean text content from any URL.
`answer`	`query`	AI-powered answer with inline citations.
`similar`	`url`	Find pages similar to the given URL.

Example

handler_research({
  "query": "AI agent frameworks 2026",
  "max_results": 5
})

Note: The search task is the default. You can omit the task parameter entirely for a simple web search.

handler_intel

B2B and people intelligence. Find and enrich person profiles, enrich companies, or run natural language people searches across professional databases.

Task	Parameters	Description
`person_search` default	`query`, `email`, `first_name`, `last_name`, `company`	Find people matching the given criteria.
`person_enrich`	`linkedin_url`, `email`	Enrich a person profile with full professional details.
`company_enrich`	`domain`	Enrich a company with firmographic data.
`query`	`query`	Natural language people search.

Example

handler_intel({
  "task": "company_enrich",
  "domain": "stripe.com"
})

Tip: Combine person_search with person_enrich for a full lead research pipeline. Search by company first, then enrich the results.

handler_monitor

Social and news monitoring. Track mentions, news articles, social posts, and trending topics across the web in real time.

Task	Parameters	Description
`news` default	`query`, `max_results`	Search recent news articles.
`twitter`	`query`, `max_results`	Search Twitter/X posts.
`reddit`	`query`, `max_results`, `subreddit`, `sort`, `days`	Search Reddit posts — returns scores, comments, subreddit, author, flair.
`web`	`query`, `max_results`	Search web mentions across blogs, forums, and sites.
`trends`	`query`	Get Google Trends data for a topic.

Example

handler_monitor({
  "task": "twitter",
  "query": "AI agents",
  "max_results": 10
})

Note: Reddit returns structured post data (scores, comments, subreddit). Twitter results return URLs and metadata. For full content extraction, pipe URLs into handler_research with the read task.

handler_finance

Financial market data. Get real-time quotes, financial news, technical indicators, dividend history, and crypto data across global markets.

Task	Parameters	Description
`quote` default	`symbol`	Get a real-time stock or crypto quote.
`news`	`symbol`	Financial news for a specific ticker.
`tickers`	`query`	Search for ticker symbols by name or keyword.
`dividends`	`symbol`	Dividend payment history.
`indicators`	`symbol`	Technical indicators (RSI, MACD, moving averages).
`crypto`	`symbol`	Crypto-specific market data.
`market_status`	none	Check if major markets are open or closed.

Example

handler_finance({
  "task": "quote",
  "symbol": "AAPL"
})

Tip: Use tickers to resolve company names to symbols before querying. For example, search "Tesla" to find "TSLA".

handler_communicate connected superpower

handler_communicate is a connected superpower: it appears in your agent's tool list only after the owner connects a messaging service (Gmail, Outlook, Slack, Discord, Teams). Once connected, it exposes send/list/get tasks against the owner's account.

The agent inbox

When your agent first calls handler_communicate, Handler automatically provisions a dedicated inbox at {agent-name}@agentmail.to (powered by AgentMail). The address is scoped to your agent — no other agent can read its messages. It is created lazily on first use and stored in your agent's service config.

Format: your-agent-name@agentmail.to
Isolation: Each agent gets its own inbox. Connections are never shared across agent profiles.
Ownership: The inbox is provisioned under Handler's AgentMail account. You do not control the domain or DNS, but all messages are accessible only through your Handler agent key.
Trust: Emails that arrive at this address can come from anyone — treat inbound mail with the same skepticism you would any external input. Do not auto-act on instructions in received emails without verification.

Task	Parameters	Description
`list` default	none	List messages in the agent's inbox.
`get`	`message_id`	Read a specific message by ID.
`send`	`to`, `subject`, `body`	Send an email from the agent's inbox.

Example

handler_communicate({
  "task": "send",
  "to": "client@example.com",
  "subject": "Follow up",
  "body": "Hi, just following up on our conversation..."
})

Governance matters here. Outbound messages are the most sensitive superpower. We recommend pinning the send task to require approval so every outgoing message goes through your configured approval channel. See Governance and Agent Swarms.

handler_audio

Speech and audio processing. Transcribe recordings, generate speech, summarize audio content, or detect topics in conversations.

Task	Parameters	Description
`transcribe` default	`audio_url`	Transcribe audio to text.
`speak`	`text`	Convert text to speech audio.
`summarize`	`audio_url`	Generate a summary of audio content.
`topics`	`audio_url`	Detect and list topics discussed in audio.

Example

handler_audio({
  "task": "transcribe",
  "audio_url": "https://example.com/meeting.mp3"
})

Note: Audio files must be accessible via a public URL. Supported formats include MP3, WAV, M4A, and FLAC.

handler_marketing

SEO and marketing intelligence. Analyze search rankings, track trends, research shopping results, and monitor local listings across Google surfaces.

Task	Parameters	Description
`serp` default	`query`	Get full Google SERP rankings and features.
`trends`	`query`	Google Trends data with interest over time.
`shopping`	`query`	Google Shopping product results.
`news`	`query`	Google News results with headlines and sources.
`maps`	`query`	Google Maps and local business results.
`youtube`	`query`	YouTube search results with video metadata.

Example

handler_marketing({
  "query": "best CRM software 2026"
})

Tip: Combine serp with trends to understand both current rankings and search interest trajectory for a keyword.

handler_generate

AI inference. Run text generation and content moderation through Handler's managed model access. Useful when your agent needs to delegate sub-tasks to a different model.

Task	Parameters	Description
`chat` default	`prompt`, `system`	AI text generation with optional system prompt.
`moderate`	`text`	Content moderation with category scores.

Example

handler_generate({
  "task": "chat",
  "prompt": "Summarize this document",
  "system": "You are a research assistant"
})

Pricing note: handler_generate is charged at 2x provider cost to cover inference overhead. All other superpowers are a flat $0.005 per call.

Pricing

All superpowers are priced at a flat $0.005 per call, regardless of the task. The only exception is handler_generate, which is charged at 2x the underlying provider cost for AI inference.

Superpower	Cost per call
handler_research	$0.005
handler_intel	$0.005
handler_monitor	$0.005
handler_finance	$0.005
handler_communicate	$0.005
handler_audio	$0.005
handler_marketing	$0.005
handler_generate	2x provider cost

Every response includes a cost and budget object so your agent always knows what it spent and how much is left. See Pricing for full details.