Skip to main content
Glama
demandex-mcp
by jcislo

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).


Related MCP server: mcp-x402

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

Available Tools

7 tools
gauge_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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      The 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
      -
    • F
      license
      B
      quality
      D
      maintenance
      MCP 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
      -