Skip to main content
Glama

ScalpStream MCP server

Listed on mcpservers.org

Pay-per-call MCP server for Claude Desktop, Claude Code, Cursor and any MCP client: US product recalls, US border wait times, cheapest fuel prices, air quality and a wash-sale check on your own trades, settled in USDC over x402 on Base.

An MCP server that buys small, factual datasets at call time with your own wallet, over x402 — roughly $0.01 a call, no account, no subscription, no API key anywhere in the flow.

Most MCP servers wrap an API you already hold a key for. This one pays as it goes. The seller holds no keys either: settlement runs through a facilitator that sponsors gas, so the only key in the system is yours, held in memory for the lifetime of the process and never written anywhere.

It is useful before you fund anything. With no key configured, every paid tool returns the free preview and the exact quoted price, so you can see what you would be buying before deciding to buy it.

Tools

Tool

What you get

product_recalls

Active US recalls for a product, brand, ingredient or vehicle across FDA, NHTSA and CPSC in one query, with severity normalised onto one scale, the hazard, the remedy, and the lot numbers that tell whether a specific unit is affected.

border_crossings

US ports of entry ranked by all-in time — drive plus current CBP wait — per lane type. The nearest crossing is often not the fastest.

cheapest_fuel

Cheapest fuel by location and grade. Station-level for Spain, France, Italy; official regional averages for the US.

air_quality

Current AQI and pollutants anywhere in the world, an EPA-based verdict on exercising outdoors, and the cleanest window ahead.

wash_sale_check

The US wash-sale rule (IRC 1091) applied to the user's own trades across taxable, IRA and spouse accounts: would buying or selling a ticker on a date wash a loss, by how much, and the first safe rebuy date; or the whole ledger with adjusted basis and the year's totals. A rule calculation, not tax advice; the service keeps nothing.

payment_status

What's configured, what's been spent. Makes no network call and costs nothing.

my_engine_status

ScalpStream managed-trading subscribers only. Your own engine's status as it reports it every minute: running, paused, halted, crash mode or unarmed and why; equity; what it realized all-time and over 24 h, 7 d, 30 d; open positions with the bid and what selling would net; the last 20 closes. Free, no x402; needs your status token in SCALPSTREAM_STATUS_TOKEN. A record of your own ledger, not a forecast.

Each paid tool calls one ScalpStream service, and every service has its own page with a free preview and an OpenAPI document: RecallScout (product_recalls), BorderScout (border_crossings), FuelScout (cheapest_fuel), AirScout (air_quality) and BasisScout (wash_sale_check).

Withdrawn tools are listed under Versions.

Related MCP server: Paid Business Data MCP Server

Install

Docker (no toolchain needed)

The published image is ghcr.io/dv1-321/scalpstream-mcp. It runs as a non-root user on a shell-less base and speaks MCP over stdin/stdout, so it needs -i and nothing else:

docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:latest

Claude Desktop (claude_desktop_config.json) or any MCP client that takes a command, preview-only:

{
  "mcpServers": {
    "scalpstream": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/dv1-321/scalpstream-mcp:latest"]
    }
  }
}

Claude Code:

claude mcp add scalpstream -- docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:latest

To enable paid calls, put the key in the client's env block and forward it with a bare -e NAME — the name only, so the value never appears in the command line:

{
  "mcpServers": {
    "scalpstream": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "EVM_BASE_PRIVATE_KEY", "-e", "SCALPMCP_BUDGET_USD",
               "ghcr.io/dv1-321/scalpstream-mcp:latest"],
      "env": {
        "EVM_BASE_PRIVATE_KEY": "0x...",
        "SCALPMCP_BUDGET_USD": "2.00"
      }
    }
  }
}

Each release is also tagged (:v0.1.14 and so on) for installs that want to pin one; the MCP registry entry pins the exact tag.

Claude Code can also take it as a plugin, which installs the same Docker command with no secrets and bundles the scalpstream-data skill:

/plugin marketplace add DV1-321/scalpstream-mcp
/plugin install scalpstream@scalpstream-mcp

Gemini CLI reads the gemini-extension.json at the root of this repository:

gemini extensions install https://github.com/DV1-321/scalpstream-mcp

Both pin the release tag and start preview-only. To pay, add the key to the installed server's env as described above; never to the manifest.

Go

go install github.com/DV1-321/scalpstream-mcp/cmd/scalpmcp@latest

This puts scalpmcp in $(go env GOPATH)/bin:

{
  "mcpServers": {
    "scalpstream": {
      "command": "scalpmcp",
      "env": {
        "EVM_BASE_PRIVATE_KEY": "0x...",
        "SCALPMCP_MAX_PRICE_USD": "0.10",
        "SCALPMCP_BUDGET_USD": "2.00"
      }
    }
  }
}

Omit env entirely to run in preview-only mode.

Configure

Variable

Default

Meaning

EVM_BASE_PRIVATE_KEY

(unset)

Base-mainnet key holding a little USDC. Unset = preview-only.

SCALPMCP_MAX_PRICE_USD

0.10

Refuse any single call quoted above this. 0 turns spending off, even with a key set. A negative or unreadable value turns spending off too, with a warning in the log.

SCALPMCP_BUDGET_USD

2.00

Refuse once the process has spent this much in total. 0 turns spending off, even with a key set. A negative or unreadable value turns spending off too, with a warning in the log.

SCALPMCP_FUEL_URL, _AIR_URL, _BORDER_URL, _RECALL_URL, _BASIS_URL, _ENGINE_URL

the live services

Override a service origin, for testing against a stub. _ENGINE_URL must be https or this machine, or my_engine_status refuses to send the status token.

SCALPSTREAM_STATUS_TOKEN

(unset)

Managed-trading subscribers: the status token from your enrolment page (st-...), for my_engine_status. It reads your engine's status and can do nothing else; a leaked one shows your positions to whoever holds it, so treat it as private. Forward it to Docker by name (-e SCALPSTREAM_STATUS_TOKEN) like the spending key.

Paying without a crypto wallet

The same data runs as Apify Actors, billed to your Apify plan instead of a wallet. Apify's hosted MCP server exposes any Actor as a tool, so an MCP client that cannot hold a key can reach the same lookups through it with an Apify account:

Those links authenticate with your Apify account; this server has no part in them and never needs your Apify token.

Preview mode examples

Captured from the image running with no key. payment_status is local:

{
  "paid": false,
  "complete": true,
  "source": "local",
  "data": {
    "paid_mode_enabled": false,
    "paid_calls": 0,
    "spent_atomic_usdc": "0",
    "price_per_call": "$0.01 USDC",
    "rails": ["USDC on Base (used by this client)", "USDC on Arbitrum", "USDC on Polygon", "USDC on Solana", "XRP on XRPL", "RLUSD on XRPL"],
    "custody": "The seller holds no keys. This client signs with your own Base key, held only in memory for the process lifetime.",
    "how_to_enable": "Ask the user to add EVM_BASE_PRIVATE_KEY ... to the MCP server's environment ... Never request, accept or echo the key in chat. ..."
  }
}

product_recalls with {"product": "infant formula"} and no key comes back with paid: false, complete: false, the service's free preview under data, and the quote under price — that is the designed outcome, not an error:

{
  "paid": false,
  "complete": false,
  "source": "https://recallscout.scalpstream.com/preview",
  "reason": "no spending key configured (set EVM_BASE_PRIVATE_KEY in the MCP server's environment to enable paid calls)",
  "price": { "network": "eip155:8453", "amount_usd": "0.0100", "amount_atomic": "10000", "asset": "0x8335...2913", "pay_to": "0x..." },
  "note": "This is the FREE PREVIEW, not the paid dataset. The paid call returns the full result described by this tool.",
  "howto": "Ask the user to add EVM_BASE_PRIVATE_KEY ... Never request, accept or echo the key in chat. ...",
  "data": {
    "service": "RecallScout",
    "what": "Machine-payable US recall lookups across three regulators at once: FDA (food, drugs, medical devices), NHTSA (vehicles) and CPSC (consumer products). ...",
    "parameters": { "product": "product, brand or ingredient — matched as a phrase across FDA and CPSC", "make": "...", "model": "...", "year": "...", "include_ended": "...", "limit": "..." },
    "honesty": "If an agency cannot be reached the response says so in sources_failed and sets complete=false. A lookup that could not consult all three is never reported as an all-clear.",
    "source": "US FDA (openFDA enforcement), US NHTSA (vehicle safety recalls), US CPSC (saferproducts.gov). Public domain / US Government works.",
    "disclaimer": "..."
  }
}

With a key the same call returns paid: true, complete: true and the recall list under data. Every tool uses this one envelope; complete is the field to branch on.

Spending safety

Real money moves, so the design refuses rather than overspends:

  • Both limits are checked before anything is signed. A refusal costs nothing and never reaches the network.

  • An unset limit means the default, never "unlimited." A missing config line must not become unbounded spending.

  • Spend is recorded only when the data is actually delivered. If a paid request then fails, the error says settlement state is unknown rather than implying nothing moved — you may need to reconcile against the chain.

  • A paid reply that cannot be delivered is reported as paid, not as an error. If the seller answers a paid request with 200 and a body that is not JSON, is empty, or is over the 1 MiB limit, the result says paid: true, complete: false, names the reason in undelivered, and carries the payment reference in payment (the terms signed, the EIP-3009 authorization nonce, and the seller's transaction hash when it sent one), so the charge can be found rather than repeated by a retry.

  • Gas is sponsored by the facilitator, so the wallet needs USDC and no ETH.

Use a throwaway key funded with a dollar or two. Never one holding balances you care about, and never hand it to a hosted service — this server is the only thing that should hold it, and it holds it only in memory.

Identification, rate limits and logging

Every request this server makes carries the header User-Agent: scalpmcp/<version> (+https://github.com/DV1-321/scalpstream-mcp), on the unpaid request and on the paid retry alike. It names the program and its version and nothing about you.

Each ScalpStream host applies an edge rate limit of 60 requests per minute per User-Agent, and every install of this server presents the same User-Agent, so all installs share that allowance on each host. At one request per tool call this is far above normal agent use; a 429 means the shared allowance is busy for the rest of that minute, not that your key or budget is at fault.

The server writes one line to stderr per tool call — the tool name, whether it paid, whether the result was complete or a preview, the last HTTP status and the elapsed milliseconds, for example scalpmcp: call tool=border_crossings paid=true complete=true status=200 ms=412 error=false. It never logs argument values, the spending key, or the payment payload.

Protocol

MCP 2025-06-18 over stdio. A client that opens with the 2026-07-28 server/discover call gets JSON-RPC -32601 (method not found), which is that revision's signal to fall back to initialize; the server then negotiates 2025-06-18.

Payment rails

Sellers accept USDC on Base, Arbitrum, Polygon and Solana, and XRP or RLUSD on the XRP Ledger. This client pays USDC on Base, preferring it over other EVM rails regardless of the order the server lists them in.

What the data is not

Every response carries its own disclaimer and source attribution; read them. Recall results are public-safety information, not legal or medical advice. A wash-sale check is a record-keeping calculation on the trades you sent under the US rule, matched on the same ticker only; it is not tax advice and never computes tax owed. The trades travel in the request and the service processes them in memory, storing and logging nothing; this server never logs them either.

Your own engine (managed-trading subscribers)

ScalpStream also runs a managed trading engine on a subscriber's own Coinbase account (monthly plans at https://www.scalpstream.com/pricing-plans/plans-pricing; the key goes into a vault from the enrolment page in the welcome email and the operator never sees it). The enrolment page shows a status token once. Put it in this server's environment as SCALPSTREAM_STATUS_TOKEN and ask your assistant how your engine is doing: my_engine_status returns the engine's own minute-by-minute report, served by the vault with its age. The token can only read that status - it cannot trade, sign or withdraw - and the server never logs it. The same report is on the status page the welcome email names.

Versions

Releases are the Git tags on this repository; each one is published to the MCP registry as io.github.DV1-321/scalpstream-mcp and as the ghcr.io/dv1-321/scalpstream-mcp image. CHANGELOG.md has the details per release.

Withdrawn in 0.1.10: options_research, municipal_income, crypto_research and crypto_yields. The ScalpStream Research boards behind them have been withdrawn. Every path on their host answers 410 Gone with "error": "withdrawn", ahead of any payment, so a 0.1.9 or older server that calls one of these tools gets that 410 rather than data and is charged nothing. Upgrade to 0.1.10 or later, where none of them is listed.

air_quality stays. AirScout now serves its own copy of the Copernicus CAMS forecast through a self-hosted Open-Meteo, and every answer carries the Open-Meteo and Copernicus credits.

License

MIT - see LICENSE.

Available Tools

8 tools
air_qualityAir quality and the cleanest window to be outsideA

Current US AQI and pollutant breakdown for any coordinates worldwide, an EPA-based verdict on whether it is safe to exercise outdoors, and the cleanest contiguous window in the forecast ahead for a session of a given length. Modelled data (Copernicus CAMS), not a sensor at the exact spot.

Inputs: lat (required), lon (required), hours, place, +1 more.

border_crossingsFastest US border crossing by all-in timeA

Ranks US ports of entry by ALL-IN time — the drive there plus the current CBP wait once there — for passenger, commercial or pedestrian traffic, honouring which lanes the traveller may actually use. The nearest crossing is frequently not the fastest. Live CBP data across all 85 US ports of entry.

Inputs: lat (required), lon (required), lanes, limit, +3 more.

cheapest_fuelCheapest fuel near a locationA

Cheapest fuel for a location and grade. Station-level pricing where governments publish open data (Spain, France, Italy); official regional averages for the US via EIA. With smart=true the ranking weighs the pump price against the fuel and time spent on the detour, so the cheapest sign is not always the cheapest tank.

Inputs: country (required), lat, lon, grade, +2 more.

crypto_researchCryptocurrency candidatesA

Ranked cryptocurrency candidates using the same technical signals as the equity feed (RSI, ATR, VWAP, momentum) plus a macro overlay from the Fear & Greed index and news sentiment. Impersonal research data, not advice.

Inputs: no named parameters.

crypto_yieldsCrypto staking and interest yieldsA

Where to earn interest or staking rewards on crypto and stablecoins: DeFi staking APY, stablecoin lending and savings rates, and liquidity-pool yields across CeFi platforms and DeFi protocols, risk-adjusted by pool depth (TVL) and base-versus-emission share, with A/B/C ratings.

Inputs: no named parameters.

municipal_incomeFederally tax-exempt municipal incomeA

Municipal bond funds and muni closed-end funds whose distributions are exempt from US federal income tax, ranked, with tax-equivalent yields computed for the 24%, 32% and 37% brackets, current yield, distribution frequency, growth streak and years without a cut. Impersonal research data, not advice.

Inputs: no named parameters.

options_researchUS equity options candidatesA

Ranked short-term US equity options candidates with the observed metrics behind each ranking (signal strength, score, ATR%, relative volume, RSI, VWAP distance, ATM IV, daily trend, momentum) and an illustrative contract. Impersonal research data, identical for every buyer — not advice, and it carries no trade plan, position sizing, or buy/sell verdict.

Inputs: no named parameters.

payment_statusPayment configuration and spend so farA

Reports whether paid calls are enabled, how much this session has spent, the price per call, and which payment rails the services accept. Makes no network request and costs nothing.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinctly different domain: options, municipal bonds, crypto research, crypto yields, fuel prices, air quality, border crossings, and payment status. Even the two crypto tools are clearly separated by purpose (research versus yields). No two tools overlap in function.

    Naming Consistency5/5

    All tool names use lowercase snake_case and follow a consistent noun-phrase pattern (e.g., options_research, municipal_income, border_crossings). There is no mixing of styles or verbs, making the naming predictable and uniform.

    Tool Count4/5

    With 8 tools, the count is within the typical well-scoped range. However, the breadth of topics suggests the server may be trying to cover too many unrelated domains for a single service, which slightly reduces appropriateness from an ideal focused set.

    Completeness2/5

    Given the name 'ScalpStream,' the server implies a focus on short-term trading, yet it lacks tools for real-time quotes, trade execution, or even general stock research. The unrelated tools (fuel, air quality, border crossings) do not fill this gap, leaving the core trading surface significantly incomplete.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Eight crypto and DeFi data tools for AI agents: prices, gas, one ParaSwap route quote, GoPlus token security and top-holder samples, DefiLlama yields, Hyperliquid/dYdX funding, and observed wallet balances. Inspect prices free; pay 0.001–0.008 USDC per call on Base through x402. No API key or subscription.
      8
      107 npm
      MIT
    • 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
      -
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP server exposing 1,000+ pay-per-call API endpoints across agent infrastructure (memory, coordination, secrets, verification), data, compute, finance, weather, geography, and reference categories — payments via x402 protocol in USDC on Base.
      -