# iwant.fyi

iwant.fyi connects AI assistants to commerce networks to discover products, run cross-source search, and post purchasing intents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 6979 installs
- Author: iwantfyi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/iwantfyi/iwant
- Updated: 2026-06-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/iwantfyi

## What it does

This server acts as the reference implementation for the open iwant.fyi demand-side protocol v1.0. Instead of querying separate storefronts, an agent submits consumer criteria and receives ranked product matches across multiple commerce feeds, including Shopify Catalog. Results arrive with normalized fields such as GTIN and brand identifiers.

The toolset handles both quick lookups and persistent purchasing flows. The `demand.search` tool checks prices without storing state. Meanwhile, `demand.create_want` stores active buyer requests with budget and location constraints. Outcome logging via `demand.record_outcome` is required to attribute finalized orders back to the originating buyer agent.

## Requirements
- Remote server: `https://iwant--iwantfyi.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http iwant https://iwant--iwantfyi.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add iwantfyi --url https://iwant--iwantfyi.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "iwantfyi": {
            "url": "https://iwant--iwantfyi.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "iwantfyi": {
            "type": "http",
            "url": "https://iwant--iwantfyi.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http iwantfyi https://iwant--iwantfyi.run.tools
```

## When to use it
- Compare product listings across several merchant feeds in one call
- Publish structured purchase requests with budget and location constraints
- Inspect open buyer requests to respond with seller inventory
- Record funnel events like checkout starts for agent attribution

## Example prompts
- Run `demand.search` to find wireless noise-cancelling headphones under 100 dollars
- Create a buyer request for an office desk in Berlin using `demand.create_want`
- Check supported categories and attributes with `demand.list_verticals`

## Similar
- [ucp](https://affpapa.org/en/nevibecode/skills/ucp.md) — skill · ★ 8052 repo stars
- [UCP Gateway](https://affpapa.org/en/nevibecode/mcp/ucp-gateway.md) — MCP server · 3618 installs
- [ShopSavvy](https://affpapa.org/en/nevibecode/mcp/shopsavvy.md) — MCP server · ★ 10 repo stars
- [Arugula](https://affpapa.org/en/nevibecode/mcp/arugula.md) — MCP server
- [UCP Checker](https://affpapa.org/en/nevibecode/mcp/ucp-checker.md) — MCP server · 2529 installs
- [Surprise Buddy](https://affpapa.org/en/nevibecode/mcp/surprise-buddy.md) — MCP server · 4734 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
