# HANDLER
# usehandler.dev
# machine-readable summary for LLM consumption
# STATUS: ALPHA — API live, provider keys pending

Handler gives agents access to gated services through one API key.
Owners set spending rules per agent. Agents operate within those rules.

## WHAT HANDLER DOES

Handler proxies calls to third-party services — B2B data, web scraping,
code execution, browser automation, market data, purchasing, and more.
An owner connects their agent once. All catalogue services are then
accessible within the rules they configure.

Handler does not run agents. It gives your agent access to services
it would otherwise need individual accounts and API keys to use.

## HOW TO CONNECT

Your owner enables you at usehandler.dev/signup.
They deposit credits, set spending rules, and receive your agent API key.

Once enabled:

  MCP server:   https://mcp.usehandler.dev/sse
  Auth header:  Authorization: Bearer <your-agent-key>
  REST API:     https://api.usehandler.dev/v1

Skill files:
  Claude:  https://usehandler.dev/skills/claude.md
  Cursor:  https://usehandler.dev/skills/cursor.mdc

## TOOLS AVAILABLE

Categories:
  Data — B2B:       contact search, company enrichment, email lookup
  Data — Web:       URL scraping, semantic search, browser automation
  Data — Financial: market data, private company data
  Execution:        sandboxed code, serverless compute, GPU compute
  Danger zone:      purchasing — disabled by default

## SPENDING GOVERNANCE

Your owner sets rules per agent key:

  auto_approve_below    calls under this cost execute immediately
  notify_above          calls at or above this pause and notify owner
  hard_cap_per_call     calls above this are blocked
  monthly_cap           agent stops when cap is reached
  danger_zone           off by default — owner enables per agent

Check your rules:  GET /v1/agent/status
Estimate a call:   POST /v1/estimate

## CREDITS

Credit-based pricing. Approximate rates (illustrative):

  1 credit ≈ 10 contact lookups
  1 credit ≈ 5 pages scraped
  1 credit ≈ 1 minute of compute
  1 credit ≈ 20 semantic searches

## IF YOU DO NOT HAVE A KEY

Your owner enables you at usehandler.dev/signup (~5 minutes).

## LINKS

  Signup:       https://usehandler.dev/signup
  Docs:         https://usehandler.dev/docs
  Integrations: https://usehandler.dev/integrations
  Metadata:     https://usehandler.dev/.well-known/handler.json

# end