{"openapi":"3.1.0","info":{"title":"Agentropolis API","version":"0.1.0","contact":{"name":"Agentropolis","email":"hello@agentropolis.io","url":"https://agentropolis.io"},"description":"Search MCP servers, x402/MPP paid APIs, A2A agents and kits. Read-only, free, no payments.","x-guidance":"Call GET /api/v1/search?q=<task>. Use results[].id with /api/v1/listings/{id}/kit.json for invocation details. First-party kits are in featured_first_party; sponsored is always separate."},"servers":[{"url":"https://agentropolis.io"}],"paths":{"/api/v1/search":{"get":{"operationId":"search","summary":"Search listings","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Task or keywords"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["kit","http_api","mcp_server","a2a_agent"]}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"rail","in":"query","required":false,"schema":{"type":"string","enum":["x402","mpp"]}},{"name":"source","in":"query","required":false,"schema":{"type":"string"}},{"name":"max_price_usd","in":"query","required":false,"schema":{"type":"number"}},{"name":"min_trust","in":"query","required":false,"schema":{"type":"number"}},{"name":"paid_only","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"has","in":"query","required":false,"schema":{"type":"string"},"description":"Comma list of discovery files: openapi,llms_txt,x402_manifest,agent_card"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"results, featured_first_party, sponsored (empty), also_search","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/listings/{id}":{"get":{"operationId":"getListing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listing","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found"}}}},"/api/v1/listings/{id}/kit.json":{"get":{"operationId":"getKitManifest","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"kit.json v0.1","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/call/{id}":{"post":{"operationId":"callKit","summary":"Non-custodial x402 pass-through to the seller (also GET/PUT/PATCH/DELETE)","description":"Forwards the request to the seller. 402 responses (body + PAYMENT-REQUIRED header) are returned unchanged. Retry with X-PAYMENT or PAYMENT-SIGNATURE signed by your own wallet; forwarded unchanged. Settlement returned in PAYMENT-RESPONSE / X-PAYMENT-RESPONSE. No custody, no fees.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"endpoint","in":"query","required":false,"schema":{"type":"string"},"description":"Path or https URL on the seller host"},{"name":"relay_info","in":"query","required":false,"schema":{"type":"string"},"description":"Return relay eligibility instead of calling"},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Seller response"},"402":{"description":"Seller payment requirements, unchanged"},"422":{"description":"Listing not relayable (link out)"},"429":{"description":"Rate limited"}}}},"/api/v1/categories":{"get":{"operationId":"categories","responses":{"200":{"description":"Categories","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/sources":{"get":{"operationId":"sources","responses":{"200":{"description":"Sources and terms decisions","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/stats":{"get":{"operationId":"stats","responses":{"200":{"description":"Index counts","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/trust/method":{"get":{"operationId":"trustMethod","responses":{"200":{"description":"Trust method","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/business-model":{"get":{"operationId":"businessModel","summary":"How the hub makes money (never in the transaction path)","responses":{"200":{"description":"Business model","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/roadmap":{"get":{"operationId":"roadmap","responses":{"200":{"description":"Live vs stubbed features","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/market/reports":{"get":{"operationId":"marketReports","summary":"Free preview of market data (paid tier is a stub)","responses":{"200":{"description":"Market preview","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/sponsored":{"get":{"operationId":"sponsored","responses":{"501":{"description":"Not implemented yet (roadmap stub)"}}}},"/api/v1/sellers/login":{"post":{"operationId":"sellerLogin","summary":"Email a magic sign-in link (transactional, to the address entered)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]}}}},"responses":{"200":{"description":"Sent","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/sellers/me":{"get":{"operationId":"sellerMe","summary":"Signed-in seller, claims and basic stats (cookie session)","responses":{"200":{"description":"Seller","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/sellers/claim":{"get":{"operationId":"listClaims","responses":{"200":{"description":"Claims","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"createClaim","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"listing_id":{"type":"string"},"method":{"type":"string","enum":["well_known","dns_txt","contact_email"]}},"required":["listing_id"]}}}},"responses":{"200":{"description":"Claim + instructions","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/sellers/claim/{id}/check":{"post":{"operationId":"checkClaim","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verification result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/go/{id}":{"get":{"operationId":"clickThrough","summary":"Logs an anonymous click and 302-redirects to the listing URL","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"sid","in":"query","required":false,"schema":{"type":"string"}},{"name":"pos","in":"query","required":false,"schema":{"type":"integer"}},{"name":"src","in":"query","required":false,"schema":{"type":"string","enum":["web","api","mcp","a2a"]}}],"responses":{"302":{"description":"Redirect"}}}},"/api/v1/sellers/verify":{"post":{"operationId":"sellerVerify","responses":{"501":{"description":"Not implemented yet (roadmap stub)"}}}},"/api/v1/sellers/me/analytics":{"get":{"operationId":"sellerAnalytics","summary":"Basic stats live; advanced is a stub","responses":{"200":{"description":"Stats","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/tools/kit-builder":{"post":{"operationId":"kitBuilder","responses":{"501":{"description":"Not implemented yet (roadmap stub)"}}}},"/api/v1/buyers/account":{"get":{"operationId":"buyerAccount","responses":{"501":{"description":"Not implemented yet (roadmap stub)"}}}}}}