demandex-mcp
MCP server for Demandex — pay-per-call e-commerce demandintelligence for AI agents. Demandex mines Reddit complaint/intent posts across ~70communities into scored opportunity cards with verbatim evidence and permalinks, andanswers ad-hoc demand verdicts for any physical-product query. Pay per call with USDCon 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 opportunitycard in the same full shape as the paid get_opportunity, so you can learn the exact responseshape 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 aBase (USDC, EIP-3009) rail; this MCP settles on Base:
- The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with theaccepted terms.
- If
EVM_PRIVATE_KEYis set, the MCP settles the call via the standard@x402/fetchV2client and retries. If no key is set, the MCP returns the 402 price terms so you cansee the cost without paying. - The API returns the data plus a
charged: truemarker.
Compute-first, settle-after: Demandex computes the full answer before charging, so youare never billed for an error or an empty result (a still-warming index returns a no-charge503 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 publicReddit posts; physical products only; not professional or business advice; provided as-is. Seehttps://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
