demandex-mcp

MCP server for Demandex — pay-per-call e-commerce demand intelligence for AI agents. Demandex mines Reddit complaint/intent posts across ~70 communities into scored opportunity cards with verbatim evidence and permalinks, and answers ad-hoc demand verdicts for any physical-product query. Pay per call with USDC on Base via x402 — no signup, no accounts, no API keys.

• 2 free tools — no wallet, no API key.
• 5 paid tools — flat per-call USD prices, settled in USDC on Base Mainnet via x402.

Try before you pay: the free get_sample_opportunity tool returns a real, fixed opportunity card in the same full shape as the paid get_opportunity, so you can learn the exact response shape first.

---

Quick start

Free tier (no wallet)

{
  "mcpServers": {
    "demandex": {
      "command": "npx",
      "args": ["-y", "demandex-mcp"]
    }
  }
}

You get get_categories and get_sample_opportunity.

Paid tier (with wallet)

Add an EVM wallet private key (0x-prefixed) that holds USDC on Base Mainnet:

{
  "mcpServers": {
    "demandex": {
      "command": "npx",
      "args": ["-y", "demandex-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

The paid tools then settle each call automatically.

Install snippets

Claude Code:

claude mcp add demandex -- npx -y demandex-mcp
# with a wallet:
claude mcp add demandex --env EVM_PRIVATE_KEY=0x... -- npx -y demandex-mcp

Claude Desktop / Cursor: add the JSON block above to your MCP config (claude_desktop_config.json or .cursor/mcp.json).

---

Tools

Free tools

Tool	Endpoint	Description
get_categories	GET /v1/categories	Category index with opportunityCount, topScore, lastUpdated per category.
get_sample_opportunity	GET /v1/sample/opportunity	Real, fixed sample opportunity card showing the full paid card shape.

Paid tools

Tool	Endpoint	Price (USD)	Description
get_trending_opportunities	GET /v1/opportunities/trending	$0.01	Top 20 trending cards as teasers (id, slug, title, category, score, signalCount, lastSeen).
get_opportunities	GET /v1/opportunities	$0.02	Up to 50 cards in a category (teaser + summary). Optional minScore (0-100).
get_opportunity	GET /v1/opportunity	$0.05	One FULL card by id or slug (exactly one) — all score components, productAngle, summary, verbatim evidence[].
gauge_demand	POST /v1/gauge	$0.03	Demand verdict for a product query (3–200 chars), cached 7 days, corpus-only. Optional category.
gauge_demand_live	POST /v1/gauge/live	$0.10	Demand verdict with a LIVE Reddit search at request time (~45s budget). Same body as gauge_demand.

Prices are flat per call — no bundles, no entitlements. The verdict shape (both gauges): { query, verdictScore (0-100), demandTemperature (cold|warm|hot), rationale, topEvidence[], relatedOpportunities[], cache, fetchedAt }.

---

How payments work (x402)

Demandex speaks the x402 exact scheme. The API's 402 advertises a Base (USDC, EIP-3009) rail; this MCP settles on Base:

1. The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.
2. If EVM_PRIVATE_KEY is set, the MCP settles the call via the standard @x402/fetch V2 client and retries. If no key is set, the MCP returns the 402 price terms so you can see the cost without paying.
3. The API returns the data plus a charged: true marker.

Compute-first, settle-after: Demandex computes the full answer before charging, so you are never billed for an error or an empty result (a still-warming index returns a no-charge 503 corpus_warming).

No accounts, no API keys — just a wallet with USDC on Base Mainnet. Physical products only.

---

Environment variables

Variable	Required	Description
EVM_PRIVATE_KEY	No	0x-prefixed wallet key with USDC on Base Mainnet. Required to pay the 5 paid tools on a live API. PRIVATE_KEY is accepted as a fallback. Free tools work without it; without a key the paid tools surface the 402 price terms.
DEMANDEX_API_URL	No	Override the API base URL (default https://api.demandex.dev).

---

Disclaimer

Demandex provides informational e-commerce demand intelligence aggregated from public Reddit posts; physical products only; not professional or business advice; provided as-is. See https://api.demandex.dev/terms.txt.

Docs for agents: https://api.demandex.dev/llms.txt · full: https://api.demandex.dev/llms-full.txt

---

License

MIT © jcislo