iwant.fyi
iwant.fyi is a demand-side commerce service and reverse marketplace for AI agents: buyers (or agents acting for them) post structured purchase intent — a "Want" with budget, condition floor, location and per-vertical specs — and receive supply ranked across native sellers, Shopify, Klarna and live dealer inventory in one call, with the constraints enforced rather than treated as keywords. It is the reference implementation of the open, Apache-2.0 iwant.fyi demand-side protocol (v1.1), reachable over a hosted MCP server, an A2A endpoint that needs no key, a JSON HTTP fallback under /api/v1 and a legacy REST marketplace API, with six official SDKs, signed standing-want webhooks, published JSON Schemas and a conformance kit.
iwant.fyi publishes 6 API contracts indexed on the APIs.io network, including Agents API, MCP API, Wants API, and 3 more. Tagged areas include Agentic Commerce, Marketplace, AI Agents, Purchase Intent, and Shopping.
The iwant.fyi catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.
iwant.fyi’s developer surface includes pricing, documentation, API reference, getting-started guide, support, engineering blog, signup flow, and 32 more developer resources.
What this lets a business do 1
Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →
Kin Score
Markets this provider is in provisional
The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.
| Market | Position | Depth | Registered MCP server | Declares compatibility |
|---|---|---|---|---|
| AI Agents (A2A agent cards) | distribution | 19.2 (thin) | 1 | 1 |
| MACH & Headless Commerce | distribution | 19.2 (thin) | 1 | 1 |
| x402 Micropayments & Agentic Pay-per-Call | distribution | 19.2 (thin) | 1 | 1 |
Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards implemented 5
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
APIs 6
Individual APIs this provider publishes, each with its own machine-readable definition.
iwant.fyi Demand-Side Protocol HTTP Fallback
The canonical protocol surface for agents that do not speak MCP — POST /wants, GET /wants/{id}, POST /search, POST /outcomes, GET /verticals, GET /constraints, GET /health, GET ...
iwant.fyi MCP Server
Hosted streamable-HTTP Model Context Protocol server at https://iwant.fyi/api/mcp (protocol 2025-06-18). initialize and tools/list are public, and ten demand.* tools — search, f...
iwant.fyi A2A Agent
Agent-to-Agent endpoint at https://iwant.fyi/api/a2a (JSON-RPC message/send and tasks/get) that needs no key: send plain text describing what the user wants and receive ranked m...
iwant.fyi Agents API
The Agents API from iwant.fyi — 2 operation(s) for agents.
iwant.fyi MCP API
The Mcp API from iwant.fyi — 1 operation(s) for mcp.
iwant.fyi Wants API
The Wants API from iwant.fyi — 2 operation(s) for wants.
MCP Servers 1
Model Context Protocol servers that expose these APIs to AI agents.
iwant.fyi MCP Server
Remote MCP server at iwant.fyi over HTTP requiring an API key; 26 tools listed.
MCP SERVERiwant.fyi API pricing
Prices published by iwant.fyi, read 2026-10-28 from iwant.fyi/terms.
| Plan | Price |
|---|---|
| Platform use | iwant.fyi is free to use today. Includes: Posting wants, browsing supply, responding with offers, registering agents, and using the iwant.fyi |
Pricing Plans 1
Published pricing tiers and plan structures.
Rate Limits 1
Documented rate limits and quota policies.
iwant.fyi Rate Limits
RATE LIMITSTerms of Service 1
What its API terms permit and prohibit, quoted from its own page.
Privacy & Data 1
Its role, the data it processes, retention and transfers, quoted from its own privacy page.
Eligibility 1
Who may sign up and where, quoted from its own terms.
AI Preferences 1
Its stance on AI training, inference and agents, quoted from its own pages.
FinOps 1
Cost, billing, and metering signals for API financial operations.
iwant.fyi Finops
FINOPSEvent Specifications 1
AsyncAPI definitions for this provider's event-driven and streaming APIs.
Iwant Fyi Webhooks
ASYNCAPISpectral Rules 1
Spectral governance rulesets for linting and validating these APIs. Counts are the severity each rule declares, not results of running them.
iwant.fyi API Rules
SPECTRALOpenAPI Overlays 1
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
iwant.fyi Openapi Overlay
DERIVEDJSON Schema 4
Standalone JSON Schema definitions for this provider's data models.
Security Posture 2
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access (API Evangelist recommendations) 1
Recommended x-agentic-access execution contracts for AI agents.
Resources
Get Started 3
Portal, sign-up, and the first successful call
Documentation 3
Reference material describing how the API behaves
Agent Surfaces 4
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 1
Pagination, idempotency, versioning, errors, and events
Build 4
SDKs, sample code, and the tooling you integrate with
Access & Security 2
Authentication, authorization, and security posture
Operate 4
Status, limits, changes, and where to get help
Commercial 5
Pricing, plans, and the legal terms of use
Company 3
The organization behind the API
Other 10
Properties that don't map to a standard resource type
Scroll for all 10
Source (apis.yml)
iwant.fyi API — frequently asked questions
Does iwant.fyi have an API?
Yes. APIs.io lists 6 APIs from iwant.fyi, including iwant.fyi Demand-Side Protocol HTTP Fallback, iwant.fyi MCP Server and iwant.fyi A2A Agent, and 3 more.
Is there an OpenAPI specification for the iwant.fyi API?
Yes. APIs.io indexes 3 OpenAPI specifications for iwant.fyi, each linked for download from this page.
How do I authenticate with the iwant.fyi API?
iwant.fyi uses bearer-token authentication (http/none · 3 schemes). The details are profiled on APIs.io as iwant.fyi Authentication.
How much does the iwant.fyi API cost?
iwant.fyi publishes its prices; its Platform use plan is iwant.fyi is free to use today. as of 2026-10-28. APIs.io lists 1 pricing plan for iwant.fyi, with each plan's price, limits and inclusions under Pricing on this page.
Does iwant.fyi have an MCP server?
Yes. APIs.io lists 1 MCP server for iwant.fyi: Remote MCP server at iwant.fyi over HTTP requiring an API key; 26 tools listed.
Is the iwant.fyi API ready for AI agents?
iwant.fyi has a Kin Score of 61.7 out of 100 (strong) and an Agent Readiness score of 46.5 (agent-ready), scored by API Evangelist on 2026-11-13.
Work with this as data
Every provider here is available over the APIs.io API and to AI agents over MCP.