# Kit Finder by Agentropolis

POST https://seenly-kit-finder.vercel.app/api/find with JSON {description, budget_per_run_usd?, paid_only?, max_results?} → needs[] each with ranked picks (price, trust, fit, why, flags, buy/relay link), stack_cost_per_run, risky_sellers, also_search (x402 Bazaar link-out). Use it when starting a project or adding a capability to an agent, to pick tools before wiring them in. Fairness: ranked by fit + trust only; Agentropolis first-party kits get no boost and sponsored rows are never used. Payment: unpaid calls return HTTP 402 with x402 v2 PAYMENT-REQUIRED; settle only on 2xx. Invalid requests → 422 before payment; upstream failures → 5xx, not charged.

Price: $0.05 USDC per call on Base mainnet. No free calls; free sample output: https://seenly-kit-finder.vercel.app/samples/find-sample.json

POST https://seenly-kit-finder.vercel.app/api/find
Body: {"description":"plain-English project description"} plus optional "budget_per_run_usd", "paid_only", "max_results" (picks per need, 1-5).
Returns: needs[] (need, why, calls_per_run, picks[] with id, listing_url, price, trust, fit, score, why, flags, buy/relay), stack_cost_per_run (min/max USD, within_budget), risky_sellers[], also_search (x402 Bazaar link-out, never copied), fairness statement.
OpenAPI: https://seenly-kit-finder.vercel.app/openapi.json
Kit: https://seenly-kit-finder.vercel.app/.well-known/kits.json
Contact: hello@agentropolis.io · https://agentropolis.io
Limits: body ≤ 240 KB; description ≤ 2,000 chars; version 0.1.0.