oci ghcr.io/dv1-321/scalpstream-mcp:v0.1.3stdioMITupdated 8d ago
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.
What can you do with ScalpStream?
ScalpStream MCP server
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 |
|---|---|
options_research |
Ranked short-term US equity options candidates with the observed metrics behind each ranking. Impersonal research data — no trade plan, sizing, or verdict. |
municipal_income |
Federally tax-exempt municipal bond funds and muni CEFs, with tax-equivalent yields for the 24/32/37% brackets. |
crypto_research |
Ranked cryptocurrency candidates: technical signals plus a Fear & Greed and news-sentiment overlay. |
crypto_yields |
Where to earn interest on crypto: DeFi staking APY, stablecoin lending, liquidity-pool yields across CeFi and DeFi, risk-adjusted by TVL. |
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. |
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. |
payment_status |
What's configured, what's been spent. Makes no network call and costs nothing. |
Install
go install github.com/DV1-321/scalpstream-mcp/cmd/scalpmcp@latest
Configure
Claude Desktop (claude_desktop_config.json), Claude Code, or any MCP client:
{
"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.
| 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. |
SCALPMCP_BUDGET_USD |
2.00 |
Refuse once the process has spent this much in total. |
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.
- 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.
Payment rails
Sellers accept USDC on Base, Arbitrum and Polygon, 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
The financial tools return impersonal, general-circulation research data, identical for every buyer. They are not investment advice, not personalised, and carry no trade plan, position sizing, or buy/sell verdict. The operator trades securities that appear in these feeds. Every response carries its own disclaimer and source attribution; read them.
Install
Add ScalpStream to your client. Pick the one you use.
claude mcp add ghcr-io-dv1-321-scalpstream-mcp-v0-1-3 -- docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:v0.1.3codex mcp add ghcr-io-dv1-321-scalpstream-mcp-v0-1-3 -- docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:v0.1.3amp mcp add ghcr-io-dv1-321-scalpstream-mcp-v0-1-3 -- docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:v0.1.3{
"mcpServers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3","command":"docker","args":["run","-i","--rm","ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"type": "local",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"ghcr-io-dv1-321-scalpstream-mcp-v0-1-3": {
"command": {
"path": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/dv1-321/scalpstream-mcp:v0.1.3"
]
}
}
}
}Add to your Zed `settings.json`.
docker run -i --rm ghcr.io/dv1-321/scalpstream-mcp:v0.1.3Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
8 tools
ScalpStream exposes 8 tools to a connected agent.
- options_research
- Ranked short-term US equity options candidates with the observed metrics behind each ranking. Impersonal research data — no trade plan, sizing, or verdict.
- municipal_income
- Federally tax-exempt municipal bond funds and muni CEFs, with tax-equivalent yields for the 24/32/37% brackets.
- crypto_research
- Ranked cryptocurrency candidates: technical signals plus a Fear & Greed and news-sentiment overlay.
- crypto_yields
- Where to earn interest on crypto: DeFi staking APY, stablecoin lending, liquidity-pool yields across CeFi and DeFi, risk-adjusted by TVL.
- 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.
- 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.
- payment_status
- What's configured, what's been spent. Makes no network call and costs nothing.
Score
75 / 100
Good
- Documentation25/25
- Maintenance19/25
- Trust13/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 0 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 8 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.3Latest | Aug 7, 2026 |
| 0.1.2 | Aug 7, 2026 |