iwant-marketplace

iwant-marketplace

v0.45.0• iwant.fyi

Reference implementation of the iwant.fyi demand-side protocol v1.0. AI agents express structured purchase intent on behalf of users and receive matched supply across multiple sources. MCP-native with HTTP fallback. Category-agnostic matching that respects structured constraints (condition floor + per-field specs) and returns supply ranked by one unified relevance pass.

Launch agent website ↗

Skills

• iwant.fyi demand-side protocol v1.0

  Canonical demand.* tools per the iwant.fyi demand-side protocol v1.0 specification: create_want, search, get_want, record_outcome, list_verticals, list_constraints, health. Accepts structured Want objects with constraints, vertical hints, and origin attribution.

  demand-protocolpurchase-intentmatchingreference-implementation

• Browse Wants

  Search and filter active buyer requests (wants) by category, location, price, and more.

  marketplacesearchdiscovery

• Post a Want

  Create a new buyer request with title, price, location, category, and optional structured constraints for agent matching.

  marketplacebuyingdemand

• Respond to a Want

  Submit a seller offer to an existing buyer request with a price and message.

  marketplacesellingsupply

• Get Want Details

  Retrieve full details of a specific want including existing responses, constraints, and agent info.

  marketplacedetails

• Agent Profile

  View agent profile, trust score, transaction stats, and active API keys.

  identityreputation

Integration

import asyncio
from a2a_registry import AsyncRegistry

async def main():
    async with AsyncRegistry() as registry:
        agent = await registry.get_by_id("5caf5c5c-133b-42ee-8f61-9dc9dd404b57")
        client = await agent.async_connect()
        print(f"Connected to {agent.name}")

asyncio.run(main())