# Rainmaker Gateway - Recommend Well

> Rainmaker Gateway - Recommend Well is a paid API for AI agents from rainmaker-gateway.rainmaker-wells.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-22).

Routes a natural-language need keyword to the best-matching Rainmaker well, returning routing metadata including well ID, origin URL, tool name, price, MCP endpoint, and rationale.

## Facts

- Endpoint: POST https://rainmaker-gateway.rainmaker-wells.workers.dev/mcp?utm_source=zero.xyz#recommend-well#recommend-well
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rainmaker-gateway-recommend-well-8eb91f29
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U3cmBzzjMxq88PCDAjCnO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rainmaker-gateway-recommend-well-8eb91f29 -d '<json body>'
```

Example prompt: I need to scrape product prices from a website — which Rainmaker well should I use? Route my need and give me the MCP URL and cost so I can call it directly.

## When to prefer this

Use this endpoint when your agent needs to dynamically discover which Rainmaker well (MCP tool) to call for a given task, rather than hardcoding a specific tool. It is the entry point for any agent that doesn't yet know which Rainmaker capability to invoke. Prefer the free list-wells alternative if you just want to browse all available wells without paying per recommendation. After receiving the recommendation, always call the returned origin /mcp URL directly to avoid double-charging.

## Known failure modes

- No matching well found for the given keyword — returns an empty or null result
- Ambiguous query matches multiple wells with similar relevance — may return the highest-scored but potentially suboptimal match
- Payment failure via x402 if USDC balance is insufficient — call is not completed
- Gateway timeout if Cloudflare Worker is under load — retry recommended
- Malformed natural-language input may produce a poor match — more specific keywords yield better results

## How this service works

Keyword-route a natural-language need to the best Rainmaker well ($0.005 USDC via x402). Returns well id, origin, tool, price_usd, mcp URL, and why. After recommend, open that origin's /mcp directly — gateway does not proxy (avoids double-charge). Free alternative: list-wells.

## Output

Returns a JSON object containing the matched well's ID, origin base URL, tool name, price in USD, the MCP endpoint URL to call directly, and a human-readable explanation of why this well was recommended. The agent should then call the returned origin's /mcp endpoint directly rather than routing through the gateway again.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rainmaker-gateway-recommend-well-8eb91f29/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rainmaker-gateway.rainmaker-wells.workers.dev](https://www.zero.xyz/host/rainmaker-gateway.rainmaker-wells.workers.dev/llms.txt)