> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helve.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# LangSmith Tool Gateway

> Add 330+ pay-per-call APIs to LangSmith Tool Gateway and Tool Kits with one Helve MCP server and a hard spend cap.

LangSmith Tool Gateway lets you govern which remote MCP servers and tools your LangChain and LangGraph agents can call. By adding **Helve (`https://helve.dev/mcp`)** as a single remote MCP server, your LangSmith Tool Kits get access to 330+ web search, scraping, LLM, audio, finance, and public data APIs without managing separate vendor accounts or API keys.

## Why pair Helve with LangSmith Tool Gateway

* **One MCP server instead of dozens:** Connect `https://helve.dev/mcp` once to expose Exa, Tavily, Firecrawl, Perplexity, OpenRouter, ElevenLabs, Deepgram, SEC EDGAR, GitHub, and 260+ other providers.
* **No separate vendor billing or subscriptions:** Every call is billed per request from one prepaid Helve balance (`$1.00` free credit to start; public APIs cost `$0.00`; failed calls cost `$0.00`).
* **Hard per-key spend caps:** Set a `spend_limit_usd` cap on the Helve API key you give to LangSmith so a runaway agent loop stops at `HTTP 402` before draining your balance.
* **Small context footprint:** Helve exposes 11 discovery and execution tools (\~2,560 tokens) instead of loading hundreds of schemas into every prompt.

## Step 1: Create a capped Helve API key

1. Sign in at [helve.dev](https://helve.dev) (`$1.00` free credit, no card required).
2. Open **API keys** and create a key named `langsmith-gateway`.
3. Set a hard **Spend limit** (for example, `$25`) and copy the `sk_live_...` key.

## Step 2: Register Helve in LangSmith Tool Gateway

In your LangSmith workspace, add a new **Remote MCP Server** to your Tool Gateway:

| Field | Value |
| - | - |
| **Server name** | `helve` |
| **Transport** | Streamable HTTP |
| **Endpoint URL** | `https://helve.dev/mcp` |
| **Authentication** | Bearer token (`Authorization: Bearer sk_live_...`) or OAuth 2.1 (PKCE / DCR supported) |

Once connected, LangSmith automatically discovers Helve's MCP tools (`search_tools`, `call_tool`, `list_categories`, `search`, `extract`, `transcribe`, and `request_tool`).

## Step 3: Add Helve tools to a LangSmith Tool Kit

Assign the Helve tools you want to expose to your agent's Tool Kit:

* Give general research or autonomous agents **`search_tools`** + **`call_tool`** so they can find and call any of the 330+ APIs on demand.
* Or expose only **`search`** and **`extract`** if you want to restrict an agent to web search and page scraping.

## Step 4: Verify from curl (optional)

You can verify that your key and the remote MCP endpoint are working before adding them to LangSmith:

```bash theme={null}
curl -sS -X POST https://helve.dev/mcp \
  -H "Authorization: Bearer $HELVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

## Pricing & limits

* **Public APIs** (SEC EDGAR, Cloudflare DNS, RDAP, GitHub public search, arXiv, Wikipedia, Hacker News, npm): `$0.00` per call.
* **Metered commercial APIs** (Exa, Firecrawl, Tavily, Perplexity, OpenRouter, ElevenLabs, Deepgram): exact upstream provider cost (0% markup), only billed on success.
* **Failed or blocked calls:** `$0.00`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.