Skip to main content
Glama
letom1176-spec

orchard-data-mcp

by letom1176-spec
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

orchard-data-mcp

MCP server for orchard-data — pay-per-call market data for AI agents over x402 (USDC micro-payments on Base). No account, no API key, no subscription.

Try it in 10 seconds — no wallet, no signup

npx -y orchard-data-mcp

Add it to any MCP client with no credentials at all:

{ "mcpServers": { "orchard-data": { "command": "npx", "args": ["-y", "orchard-data-mcp"] } } }

Two tools work immediately with no wallet configured:

Free tool

What you get

list_products

Every endpoint with its live price

get_feed_status

Age of each data feed — verify freshness before paying

Ask your agent for get_feed_status first. If the feeds are stale, you have learned that for free; nothing here hides staleness to sell you a call.

Paid tools cost $0.001–$0.10 and need a burner Base wallet with a few dollars of USDC — setup below. Without a key they explain what they would cost instead of failing silently.

Related MCP server: x402-api

What makes it worth paying for

A track record you can audit. Forecasts are timestamped before the outcome and scored server-side against what actually happened, under a fixed rule shipped inside the payload. Call get_track_record for $0.01 and check our accuracy before you trust anything else we sell. Almost nothing in this category lets you do that, because almost nothing in this category would survive it.

Plus an ML market-regime forecast and a news catalyst radar, produced by a real algorithmic trading system — refreshed ~15 min during US market hours, staleness always reported.

Tools

Tool

Price/call

What

list_products

free

Product manifest with live prices

get_feed_status

free

Freshness probe — check the rig-fed products are current before paying

run_backtest ⭐

$0.10

Backtest your own entry rule on up to 10y of real daily bars: next-open fills (no look-ahead), slippage charged, train/test halves scored apart, buy&hold + SPY baselines always printed, disagreeing halves reported as noise

get_symbol_dossier

$0.02

One ticker, one call: quote + 1y technicals + expected move + regime + news catalysts. Replaces ~6 calls, priced below their sum

get_regime_forecast ⭐

$0.01

ML volatility-regime forecast + a transparent rules-based read (VIX bands, realized-vol percentile, trend)

get_track_record ⭐

$0.01

Normalized per-lane win rates + the server-side scored forecast ledger. Audit us before buying anything else

get_catalyst_radar ⭐

$0.01

Tickers with a fresh news catalyst (bullish + bearish) and the headline behind it: the trading system's AI scanner, or a disclosed 12h headline scan when it is idle

get_dip_radar ⭐

$0.01

Live dip scan over the exact 55-name book the trading system runs: RSI(2), distance from the 20-day high, tiered dip flags under disclosed thresholds

get_market_brief

$0.005

BTC/ETH/SOL + SPY/QQQ/DIA/IWM + crypto fear & greed, one call

get_trending

$0.005

StockTwits trending + r/wallstreetbets mention counts

get_movers

$0.005

Biggest US movers with live quotes, sorted by absolute move

get_expected_move

$0.005

Options-implied expected move (ATM straddle to nearest expiry), any symbol

get_macro

$0.003

Treasury yields (13w/5y/10y/30y), dollar index, gold, WTI crude, VIX

get_funding_rates

$0.003

BTC/ETH/SOL perp funding (8h + annualized), next funding time, mark price

get_fear_greed

$0.001

Crypto fear & greed index, current + previous reading

get_ohlcv

$0.002

Daily OHLCV candles, any US symbol, 5d–1y

read_web_page

$0.001

Any web page as clean markdown (title, date, text with links). Failed fetches are not charged

verify_email

$0.001

Email check: syntax, MX, disposable, role account, SPF/DMARC, with verdict and score

check_token

$0.005

EVM token safety: honeypot, taxes, owner powers, holder sell simulation, DEX liquidity, verdict

get_sentiment_brief

$0.005

Crowd mood in one call: crypto fear & greed + StockTwits trending + WSB mentions + CoinGecko trending coins

get_fear_greed_history

$0.002

Crypto fear & greed, last 30 days, with 7d/30d averages, trend and extreme-day counts

get_stocktwits_trending

$0.003

StockTwits trending symbols with watchlist counts

get_wsb_mentions

$0.003

r/wallstreetbets ticker mentions, ranked, vs 24h ago

get_crypto_trending

$0.002

CoinGecko's most-searched coins (24h) with price and 24h change

get_prediction_markets

$0.003

Live Polymarket odds for the most-traded open markets, optional keyword filter

get_quote

$0.002

Live quote, any US symbol

get_dip_check

$0.003

Is this symbol dipping? RSI(2)/RSI(14)/distance from 20-day high + verdict

get_etf_quotes

$0.003

SPY/QQQ/DIA/IWM quotes in one call

get_crypto_spot

$0.003

BTC/ETH/SOL spot + 24h change

get_crypto_global

$0.001

Total crypto market cap, volume, BTC/ETH dominance

get_yields

$0.002

Treasury yields: 13w/5y/10y/30y

get_vix

$0.001

VIX now

get_commodities

$0.002

Gold, WTI crude, dollar index

get_fx_rates

$0.001

FX rates, ~30 currencies, any base

get_gas

$0.001

Base + Ethereum gas now, with USD cost of a transfer and a swap

⭐ = unique to us, not repackaged vendor data.

The HTTP API carries more products than this server wraps — including narrow slices like /api/quote, /api/yields, /api/vix, /api/commodities, /api/crypto-spot, /api/etf-quotes, /api/wsb-mentions and /api/stocktwits-trending, plus a free full-sample response at /api/sample. See the manifest or openapi.json.

Paying for the paid tools

Paid tools need a small dedicated Base wallet holding USDC (a few dollars goes a very long way at these prices). Use a burner wallet, never your main one.

{
  "mcpServers": {
    "orchard-data": {
      "command": "npx",
      "args": ["-y", "orchard-data-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x<burner wallet private key>" }
    }
  }
}

Without EVM_PRIVATE_KEY the two free tools still work, and the paid tools explain what they would cost rather than failing silently.

How payment works

Each paid tool call: GET → HTTP 402 with payment requirements → the client signs a USDC transfer authorization with your key → retries with the payment header → JSON. Settlement is gasless for the buyer (EIP-3009 via the x402 facilitator). Verified end-to-end on Base mainnet.

The server can never charge more than the listed price. Before signing, the client checks the payment request against the tool's listed price — the one in its description and in the table above, which the test suite keeps identical. It must be USDC on Base, at or under that amount. Anything else — a bad deploy, a changed price, a mistyped ORCHARD_BASE_URL — is refused with no signature produced. A tool that is listed at $0.01 cannot cost you $1.

Errors say whether you paid. Every failure tells you whether a payment was signed, so you know whether a retry is safe. If a request dies after signing, the error says so and asks you to check the wallet before retrying, rather than inviting a retry that could pay twice.

Configuration

Variable

Default

Purpose

EVM_PRIVATE_KEY

unset

Burner Base wallet key. Unset = free tools only

ORCHARD_TIMEOUT_MS

30000

Per-call timeout, so a stalled API cannot hang your agent

ORCHARD_BASE_URL

production

Point at another deployment, e.g. for testing

Development

npm test          # offline: stub API, real MCP stdio, real x402 signing with a throwaway key
npm run test:live # check against the production API — free, needs no funds

The offline suite covers the paid path end to end — including refusing an overpriced request — without touching the network or a real wallet. It also fails if this README's price table drifts from what the server charges.

test:live costs nothing. It checks the paid path with a freshly generated empty wallet: signing a payment authorization spends nothing, so production must reject it, and that rejection proves production's payment request passes the price cap. It ignores any EVM_PRIVATE_KEY in your environment, so it can never touch a real wallet.

Available Tools

1 tool
get_catalyst_radarA

Tickers with fresh bullish news catalysts ($0.01), from an AI news scanner feeding a live trading system. Refreshed ~15min during US market hours.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does well: it discloses the refresh frequency (~15min during US market hours) and source (AI news scanner). It does not mention rate limits or auth needs, but for a read-only tool this is sufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no extraneous information. The key facts are front-loaded, and every word adds value. Perfectly concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool with no output schema, the description provides reasonable expectations: tickers with bullish catalysts and refresh timing. It could mention output format (e.g., list), but is otherwise complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so baseline is 4. The description adds no parameter details, which is appropriate given the empty input schema and 100% schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it provides tickers with fresh bullish news catalysts, making the tool's purpose immediately obvious. The verb 'get' and resource 'catalyst radar' are explicitly defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, though no sibling tools exist. The description implies use during US market hours due to refresh timing, but lacks explicit when-to-use or when-not-to-use context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 1 tool updatev1.1.2
    • First observedget_catalyst_radar
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.3/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion with other tools.

Naming Consistency5/5

Single tool adheres to a clear verb_noun pattern (get_catalyst_radar).

Tool Count3/5

With only one tool, the server's scope is very narrow; while it may be sufficient for a single purpose, it feels thin compared to typical MCP servers.

Completeness5/5

For the stated purpose of providing AI-scanned bullish news catalysts, a single retrieval tool is complete; no obvious gaps in functionality.

Resources

Related MCP Connectors

Related MCP Servers

  • market-data-mcp

    SmashToes
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
    -

  • x402-api

    fernsugi
    A
    license
    A
    quality
    C
    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
    86 npm
    MIT