# Agentropolis

> A search engine for agent-usable tools: MCP servers, x402 and MPP paid HTTP APIs, A2A agents and "kits". 38952 listings. Trust scores come only from verified, non-wash payments. Agentropolis is never a party to transactions: buyers pay sellers directly (x402/Coinbase, MPP, Stripe). No splits, referral fees or proxying.

## Use it
- Search (HTTP): GET https://agentropolis.io/api/v1/search?q=web+search&rail=x402&max_price_usd=0.05&min_trust=40
- MCP server (Streamable HTTP): https://agentropolis.io/api/mcp  (10 tools: search_kits, get_kit, get_kit_manifest, call_kit, list_categories, list_sources, trust_method, bazaar_link, market_snapshot, roadmap; all read-only except call_kit, which forwards a request to an x402 seller)
- A2A agent card: https://agentropolis.io/.well-known/agent-card.json ; JSON-RPC endpoint https://agentropolis.io/a2a (message/send)
- OpenAPI: https://agentropolis.io/openapi.json ; API catalog (RFC 9727): https://agentropolis.io/.well-known/api-catalog
- Listing: GET https://agentropolis.io/api/v1/listings/{id} ; kit manifest: GET https://agentropolis.io/api/v1/listings/{id}/kit.json
- kit.json v0.1 schema: https://agentropolis.io/spec/kit-v0.1.json ; first-party kits index: https://agentropolis.io/.well-known/kits.json

## Rules agents should know
- Seeded listings are "unclaimed": built from public metadata, not reviewed by the seller.
- First-party kits ("Featured from Seenly", an affiliated publisher) appear only in "featured_first_party" (labeled), never inside organic "results".
- "sponsored" is always a separate array (currently empty). Paid placement never changes organic rank or trust.
- trust.score null = no payment evidence (not negative). Method: https://agentropolis.io/api/v1/trust/method
- Always trust the seller's live 402 challenge over any listed price.
- Coinbase Bazaar / Agentic.Market: link-out only (their terms forbid caching/aggregation).

## Sources (terms-checked): https://agentropolis.io/api/v1/sources
Official MCP Registry (CC0) · tempoxyz/mpp services registry (MIT/Apache-2.0) · Data: x402-list.com (CC BY 4.0) · seller origins (robots-aware discovery files) · first-party kits (Seenly, affiliated)

## Buy here (x402 pass-through, non-custodial)
- Listings with links.call support https://agentropolis.io/api/v1/call/{id}?endpoint=/path : send the request as you would to the seller. On 402 you get the seller's requirements unchanged; pay the seller's payTo from your own wallet and retry with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2). Settlement comes back in PAYMENT-RESPONSE / X-PAYMENT-RESPONSE.
- Same via MCP tool call_kit and A2A skill call_kit. Agentropolis holds no keys or funds, never edits payTo/amount, never settles, charges no fees. Card-only listings: link out.
- Limits: https sellers on the listing's own host only, 256 KB request, 2 MB response, 25 s timeout, 20 calls/min per client.

## Sellers
Claim a listing at https://agentropolis.io/sellers (email sign-in; verify via /.well-known/agent-hub-verify.txt, DNS TXT, or email at your domain). Basic stats for claimed listings.

## Privacy
Searches and click-throughs (results[].links.go) are logged without raw IPs (daily-rotating salted hash). https://agentropolis.io/privacy

## Roadmap (stubs return 501): https://agentropolis.io/api/v1/roadmap
Sellers: verified badge, advanced analytics, kit builder. Buyers: premium tier with private catalogs and spend controls. Market data reports (free preview at https://agentropolis.io/api/v1/market/reports). Sponsored placement (labeled). Business model: https://agentropolis.io/api/v1/business-model

## Opt-out / corrections
Sellers who want a listing removed or corrected: claim it at https://agentropolis.io/sellers or email hello@agentropolis.io.

## Contact
hello@agentropolis.io (read by a human; no auto-replies)