# orchard-data-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/letom1176-spec/orchard-data-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1020  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/orchard-data-mcp

## Description
Pay-per-call market data for AI agents via x402 (USDC on Base): regime, track record, catalysts.

## Tools
Capabilities this server exposes over MCP:

- **list_products** — FREE, no wallet needed. Every orchard-data endpoint with its live price. Start here.
- **get_feed_status** — FREE, no wallet needed. Freshness probe for the rig-fed products (regime forecast, catalyst radar, track record): the age of each data feed, so you can verify freshness before spending on a paid call.
- **run_backtest** — $0.10/call, paid automatically in USDC on Base via x402. Honest backtest of an entry rule on up to 10y of real daily bars. No look-ahead (next-open fills), slippage charged, train/test halves scored separately, buy&hold + SPY baselines always printed, noise flagged as noise. Entry rules: rsi2_below, rsi14_below, ibs_below, dip_from_high20, down_days, sma_cross_up, gap_down.
- **get_symbol_dossier** — $0.02/call, paid automatically in USDC on Base via x402. One-call deep context on a US ticker: live quote, 1y technicals (trend, SMA distances, realized vol, 52w position, multi-horizon returns), options-implied expected move, market regime context, and news-catalyst hits from a live trading system's AI scanner. Replaces ~6 separate calls.
- **get_regime_forecast** — $0.01/call, paid automatically in USDC on Base via x402. US market regime read: ML volatility-regime forecast with independently-scored accuracy — audit the ledger via get_track_record before you buy. From a live-forward trading system (~70% walk-forward vol accuracy; direction advisory only), plus a transparent rules-based snapshot (VIX bands, realized-vol percentile, trend). Best single call for 'what kind of market is this?'
- **get_track_record** — $0.01/call, paid automatically in USDC on Base via x402. Tamper-evident trading track record: forecasts timestamped BEFORE outcomes, scored server-side against realized SPY under a fixed rule disclosed in the payload — cannot be rewritten, re-checkable, grows daily. Plus normalized per-lane win rates and system-vs-SPY multiples. Use this to audit get_regime_forecast before relying on it.
- **get_catalyst_radar** — $0.01/call, paid automatically in USDC on Base via x402. Tickers with a fresh news catalyst, bullish and bearish, with the headline behind each. Source is a live trading system's AI news scanner when it is fresh, otherwise a live scan of the last 12h of headlines across 36 high-attention US names under a disclosed keyword rule; the `source` field says which.
- **get_dip_radar** — $0.01/call, paid automatically in USDC on Base via x402. Dip radar over the exact ~55-name universe a live-forward trading system trades: RSI(2), distance from 20-day high, 1d/5d returns for every name, each flagged deep_dip/dip/near_dip/none under fully disclosed thresholds. Computed fresh from real daily bars, refreshed <=15 min, works 24/7.
- **get_market_brief** — $0.005/call, paid automatically in USDC on Base via x402. One-call market snapshot: BTC/ETH/SOL spot + 24h change, crypto fear & greed, SPY/QQQ/IWM/VIX quotes.
- **get_trending** — $0.005/call, paid automatically in USDC on Base via x402. Trending tickers: StockTwits trending symbols + r/wallstreetbets mention counts with 24h momentum.
- **get_movers** — $0.005/call, paid automatically in USDC on Base via x402. Top trending US tickers with live quotes, sorted by absolute move.
- **get_expected_move** — $0.005/call, paid automatically in USDC on Base via x402. Options-implied expected move for a US symbol: nearest-expiry ATM straddle mid as a % of spot.
- **get_macro** — $0.003/call, paid automatically in USDC on Base via x402. Macro dashboard: 13w/5y/10y/30y Treasury yields, dollar index, gold, WTI crude, VIX.
- **get_funding_rates** — $0.003/call, paid automatically in USDC on Base via x402. Perp funding rates: BTC/ETH/SOL from OKX — crowded-side gauge for crypto positioning.
- **get_fear_greed** — $0.001/call, paid automatically in USDC on Base via x402. Crypto fear & greed index, current + previous reading.
- **get_ohlcv** — $0.002/call, paid automatically in USDC on Base via x402. Daily OHLCV candles for any US symbol. range: 5d|1mo|3mo|6mo|1y.
- **read_web_page** — $0.001/call, paid automatically in USDC on Base via x402. Read any web page as clean markdown: title, description, publish date, main text with links, word count. Static HTML (no JavaScript rendering). A page that cannot be fetched is not charged.
- **verify_email** — $0.001/call, paid automatically in USDC on Base via x402. Check an email address before sending: syntax, domain exists, live MX, null MX, disposable domain, role account, free provider, SPF and DMARC. Verdict, 0-100 score and reasons. Does not probe the mailbox itself.
- **check_token** — $0.005/call, paid automatically in USDC on Base via x402. EVM token safety check before buying: honeypot, buy/sell tax, owner powers, verified source, holder sell simulation, plus live DEX liquidity, volume and pool age. Verdict, score, red flags. Chains: base (default), ethereum, bsc, arbitrum, polygon, optimism.
- **get_sentiment_brief** — $0.005/call, paid automatically in USDC on Base via x402. Crowd mood in one call: crypto fear & greed, StockTwits trending, r/wallstreetbets mention counts and CoinGecko's most-searched coins. Cheaper than the four slices separately.
- **get_fear_greed_history** — $0.002/call, paid automatically in USDC on Base via x402. Crypto fear & greed for the last 30 days: daily readings, 7d/30d averages, min/max, 7-day trend and the count of extreme-fear and extreme-greed days.
- **get_stocktwits_trending** — $0.003/call, paid automatically in USDC on Base via x402. StockTwits trending symbols right now, with watchlist counts.
- **get_wsb_mentions** — $0.003/call, paid automatically in USDC on Base via x402. r/wallstreetbets ticker mention counts, ranked, with upvotes and the change versus 24h ago.
- **get_crypto_trending** — $0.002/call, paid automatically in USDC on Base via x402. CoinGecko's most-searched coins in the last 24h, ranked, with price, 24h change, market cap and volume, plus the trending sectors.
- **get_prediction_markets** — $0.003/call, paid automatically in USDC on Base via x402. Live Polymarket odds: the most-traded open markets by 24h volume, each outcome's price as a probability, with volume, liquidity and end date. Optional keyword filter.
- **get_quote** — $0.002/call, paid automatically in USDC on Base via x402. Live quote for any US symbol: last, previous close, % change, day high/low, volume, exchange timestamp.
- **get_dip_check** — $0.003/call, paid automatically in USDC on Base via x402. Is this symbol dipping? RSI(2), RSI(14), distance from the 20-day high and a disclosed-threshold verdict, for any US ticker.
- **get_etf_quotes** — $0.003/call, paid automatically in USDC on Base via x402. SPY, QQQ, DIA and IWM live quotes in one call.
- **get_crypto_spot** — $0.003/call, paid automatically in USDC on Base via x402. BTC, ETH and SOL spot prices with 24h change.
- **get_crypto_global** — $0.001/call, paid automatically in USDC on Base via x402. Whole crypto market: total market cap, 24h volume, 24h market-cap change, BTC and ETH dominance.
- **get_yields** — $0.002/call, paid automatically in USDC on Base via x402. US Treasury curve: 13-week, 5-year, 10-year and 30-year yields.
- **get_vix** — $0.001/call, paid automatically in USDC on Base via x402. The VIX now: last, previous close, % change, day range.
- **get_commodities** — $0.002/call, paid automatically in USDC on Base via x402. Gold futures, WTI crude futures and the dollar index in one call.
- **get_fx_rates** — $0.001/call, paid automatically in USDC on Base via x402. Currency exchange rates (ECB reference, ~30 currencies) against any base, with the majors pulled out.
- **get_gas** — $0.001/call, paid automatically in USDC on Base via x402. Gas right now on Base and Ethereum: base fee, priority-fee percentiles, suggested max fee, and the USD cost of a transfer, an ERC-20 transfer and a DEX swap.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `EVM_PRIVATE_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What orchard-data-mcp does

orchard-data-mcp exposes orchard-data endpoints as MCP tools for agents that need current market and auxiliary data. Its finance coverage includes US equities, ETFs, crypto spot prices, perpetual funding, options-implied moves, macro indicators, sentiment signals, SEC filings, insider trades, and prediction-market odds. Additional tools handle web-page extraction, email checks, domain inspection, EVM token safety, and prompt-injection screening.

The server is suited to pay-per-call workflows rather than applications that require a subscription or a conventional API key. Calls are priced individually, with listed prices ranging from fractions of a cent to $0.10 depending on the operation.

## How it works

Run the package as an MCP process through `npx`. `list_products` returns the available products and their live prices, while `get_feed_status` reports feed age so an agent can check freshness before making a paid request. These two tools work without credentials.

Paid calls use the x402 payment flow. The request receives payment requirements, the client signs a USDC transfer authorization with a configured key, and the request is retried with a payment header. Settlement uses the x402 facilitator and EIP-3009 on Base, so the buyer does not pay gas for settlement. The server limits payment to the price published for the selected tool.

## Setup and configuration

The minimal command is:

```bash
npx -y orchard-data-mcp
```

An MCP client can register it with a stdio configuration such as:

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

This configuration enables the two free tools. To call paid tools, add `EVM_PRIVATE_KEY` containing a dedicated burner wallet private key. The wallet should hold USDC on Base; the project recommends keeping it separate from a primary wallet. Without that variable, paid tools explain their cost instead of completing the request.

## Tools and capabilities

Market and trading tools provide live US quotes, ETF quotes for SPY, QQQ, DIA, and IWM, BTC/ETH/SOL spot data, crypto market totals and dominance, OHLCV candles, expected moves, dip indicators, movers, macro values, funding rates and history, fear-and-greed readings, and sentiment summaries. Other tools expose StockTwits and WallStreetBets activity, CoinGecko trending coins, Polymarket odds, SEC filings, and insider transactions.

`get_symbol_dossier` groups a quote, one-year technical data, expected move, regime, and news catalysts into one ticker-level response. `read_web_page` returns page content as markdown, while `verify_email`, `get_domain_info`, `check_token`, and `check_prompt_injection` provide focused validation and safety checks.

## Limitations and notes

Data freshness varies by feed, so agents should call `get_feed_status` before paying for time-sensitive results. Paid access depends on a funded Base wallet and USDC. The server is intended for data retrieval and analysis; its outputs should not be treated as investment advice or as a substitute for independent verification.

_Full upstream README: https://allmcps.com/mcp/orchard-data-mcp/readme_