---
name: helve
description: Discover and call 313+ AI agent tools (LLMs, web search/crawl, audio/TTS, email, PDF, finance) via MCP or REST with one API key and per-key spend caps.
---

# Helve Agent Onboarding

Helve gives AI agents access to **313 live tools** across **255 providers** with one key (`sk_live_...`), **$0/mo subscription**, **non-expiring prepaid credits**, **per-key `spend_limit_usd` caps**, and **$0.00 charged on failed calls**.

## 1. Connect via MCP (OAuth 2.1 or API Key)
- **Endpoint:** `https://helve.dev/mcp` (Streamable HTTP)
- **Unauthenticated read-only discovery:** `search_tools`, `list_categories`
- **Authenticated execution:** `call_tool`, `request_tool` (via OAuth 2.1 PKCE/DCR/CIMD or `Authorization: Bearer $HELVE_API_KEY`)

## 2. Discover & Call via REST
```bash
# Search tools without an API key
curl -sS -X POST https://helve.dev/v1/tools/search \
  -H "Content-Type: application/json" \
  -d '{"query": "web search or crawl markdown", "limit": 5}'

# Call any tool with your sk_live_ key ($0.50 free starter credit on signup)
curl -sS -X POST https://helve.dev/v1/tools/call \
  -H "Authorization: Bearer $HELVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool_id": "cohere.chat", "arguments": {"messages": [{"role": "user", "content": "Hello"}]}}'
```

## 3. Request Missing Tools
If `search_tools` returns no match, log demand via `POST https://helve.dev/v1/tools/request` (`{ "tool_name": "...", "use_case": "..." }`) or MCP `request_tool`.
