{"uid":"cap_U3cmBzzjMxq88PCDAjCnO","slug":"rainmaker-gateway-recommend-well-8eb91f29","name":"Rainmaker Gateway - Recommend Well","description":"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.","url":"https://rainmaker-gateway.rainmaker-wells.workers.dev/mcp?utm_source=zero.xyz#recommend-well#recommend-well","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yX1zWMldyswYTnkYqE0NN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Routing agent to right MCP tool","prompt":"I want to summarize long documents in my agent workflow — which Rainmaker well handles that? Give me the well ID, MCP URL, and why it's the best match."},{"title":"Cost-aware tool discovery for pipeline","prompt":"My agent needs to do sentiment analysis on customer reviews. Which Rainmaker well is best for that and what will it cost per call?"},{"title":"Bootstrapping new agentic workflow","prompt":"I'm building an agent that needs to geocode addresses. Can you find me the right Rainmaker well to call, including its origin URL so I can connect directly?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:38:13.046Z","isFirstParty":false,"canonicalSlug":"rainmaker-gateway-recommend-well-8eb91f29"}