demandex-mcp
Provides e-commerce demand intelligence by mining Reddit complaint and intent posts, offering opportunity cards, trending opportunities, and demand verdicts with verbatim evidence from Reddit communities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@demandex-mcp what are the trending product opportunities right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude Desktop / Cursor: add the JSON block above to your MCP config
(claude_desktop_config.json or .cursor/mcp.json).
Related MCP server: mcp-x402
Tools
Free tools
Tool | Endpoint | Description |
|
| Category index with |
|
| Real, fixed sample opportunity card showing the full paid card shape. |
Paid tools
Tool | Endpoint | Price (USD) | Description |
|
| $0.01 | Top 20 trending cards as teasers ( |
|
| $0.02 | Up to 50 cards in a |
|
| $0.05 | One FULL card by |
|
| $0.03 | Demand verdict for a product |
|
| $0.10 | Demand verdict with a LIVE Reddit search at request time (~45s budget). Same body as |
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:
The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.
If
EVM_PRIVATE_KEYis set, the MCP settles the call via the standard@x402/fetchV2 client and retries. If no key is set, the MCP returns the 402 price terms so you can see 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 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 |
| No | 0x-prefixed wallet key with USDC on Base Mainnet. Required to pay the 5 paid tools on a live API. |
| No | Override the API base URL (default |
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
Available Tools
7 toolsgauge_demandA
PAID $0.03 via x402. Demand verdict for any physical-product query, cached 7 days by normalized query (corpus-only synthesis + 1 LLM call). Returns { query, verdictScore (0-100), demandTemperature (cold|warm|hot), rationale, topEvidence[], relatedOpportunities[], cache, fetchedAt }. Pays USDC on Base via x402. Compute-first, settle-after — you are never charged for an error. Set EVM_PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: query (required), category.
gauge_demand_liveA
PAID $0.10 via x402. Demand verdict backed by a LIVE Reddit search at request time (up to 50 posts) plus the mined corpus and one LLM synthesis call, under a ~45s budget. Same verdict shape as gauge_demand (cache always miss); timeout → no-charge 504. Pays USDC on Base via x402. Compute-first, settle-after — you are never charged for an error. Set EVM_PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: query (required), category.
get_categoriesA
Category index with opportunityCount, topScore, lastUpdated per category. Free.
Inputs: no named parameters.
get_opportunitiesA
PAID $0.02 via x402. Up to 50 opportunity cards in a category, each a teaser plus its summary. Requires category; optional minScore (0-100) filters. Unknown/missing category → no-charge 400 listing valid categories. Pays USDC on Base via x402. Compute-first, settle-after — you are never charged for an error. Set EVM_PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: category (required), minScore.
get_opportunityA
PAID $0.05 via x402. One FULL opportunity card by id or slug (provide exactly one): all score components (freqScore, intensityScore, wtpScore), productAngle, summary, evidence[] (verbatim quotes with subreddit, upvotes, permalink), builderMomentum, firstSeen, lastSeen, signalCount, distinctAuthors. Pays USDC on Base via x402. Compute-first, settle-after — you are never charged for an error. Set EVM_PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: id, slug.
get_sample_opportunityB
Real, fixed sample opportunity card showing the full paid card shape. Free.
Inputs: no named parameters.
get_trending_opportunitiesA
PAID $0.01 via x402. Top 20 trending opportunity cards by score as TEASERS (id, slug, title, category, score, signalCount, lastSeen) — no evidence; buy get_opportunity for the full card. Pays USDC on Base via x402. Compute-first, settle-after — you are never charged for an error. Set EVM_PRIVATE_KEY (wallet with USDC on Base Mainnet) to pay on a live API; without a key the call returns the 402 price terms.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: categories, sample, trending list, category list, full detail, and two demand gauges. The only potential confusion is between get_trending_opportunities and get_opportunities, but pricing and descriptions (trending vs category-based) make them differentiable.
The verb_noun pattern is consistent, with all retrieval tools prefixed get_ and analysis tools using gauge_. The shift from get_ to gauge_ is logical and doesn't break readability, but it is a minor deviation from a uniform verb.
Seven tools is well-scoped for a demand-intelligence server, covering free samples, paid tiers, and both cached and live analysis without redundancy. Each tool earns its place in the workflow.
The surface covers categories, trending, detailed cards, and demand gauging, which covers the core use case. A minor gap is the lack of keyword-based opportunity search, though gauge_demand's relatedOpportunities partially fills this.
Maintenance
Related MCP Connectors
Remote MCP server exposing 330 production AI-agent services for web/data processing, validation, AI utilities, blockchain/crypto utilities, and x402 pay-per-use access.
MCP server for X420's pay-per-call agent services (x402, USDC on Base, paid from your own wallet).
371Programmatic web-scraping MCP server powered by x402 micro-transactions on Base.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenancePay-per-call MCP server offering crypto market signals, web page extraction, and GitHub repo auditing, with automatic settlement in USDC via the x402 protocol.MIT
- FlicenseNot gradedqualityBmaintenanceThe first MCP server that pays for itself. AI agents pay for ScriptMasterLabs data autonomously via x402 — 43+ pay-per-call tools for market intelligence, SEC filings, federal grants/contracts, and more.1-
- FlicenseBqualityDmaintenanceMCP server for paid business data services with free previews and paid tools (enriched search and competitive analysis) using x402 payment flow via Pyrimid Protocol on Base.5-
- AlicenseNot gradedqualityCmaintenanceMCP server providing 50+ crypto, market intelligence, and AI inference endpoints with x402 pay-per-request micropayments on Base.2Apache 2.0