Skip to content

meridianfin/mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Meridian MCP Server

Smart money intelligence for AI agents — Congress trades, dark pool, insider trading, 13F, crypto on-chain, and more.

MCP Tools x402

Meridian provides a hosted MCP server with 34 tools covering smart money signals, crypto analytics, and macro intelligence. No local installation required — connect directly to the hosted endpoint.

Quick Start

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "meridian": {
      "url": "https://meridianfin.io/mcp",
      "transport": "streamable-http"
    }
  }
}

That's it. No API keys, no Docker, no dependencies.

Payment

Meridian uses x402 for pay-per-call pricing in USDC on Base L2. Some tools are free (market regime, crypto Fear & Greed). Most tools cost $0.03–$0.50 per call.

See the full pricing table in the OpenAPI spec (x-x402 extensions).

Available Tools

Smart Money — Government

Tool Description Price
get_congress_trades US Congress stock trading from STOCK Act disclosures $0.05
get_lobbying_activity Corporate lobbying filings linked to tickers $0.05
get_gov_contracts Government contracts from USASpending.gov $0.05

Smart Money — Institutional

Tool Description Price
get_ark_trades ARK Invest buy/sell activity across all ETFs $0.05
get_13f_filings 13F quarterly holdings (Berkshire, Bridgewater, Citadel, Soros, +80 others) $0.50
get_superinvestor_activity Portfolio changes from ~80 legendary investors $0.05
get_activist_filings SEC 13D/G activist investor filings (>5% ownership) $0.05

Smart Money — Market Signals

Tool Description Price
get_insider_trades SEC Form 4 insider trading with cluster buy detection $0.05
get_darkpool_activity FINRA dark pool anomalies via Z-score analysis $0.05
get_short_interest Short interest for 8,600+ tickers $1.00
get_confluence_signals Multi-source smart money consensus scoring $0.15

Crypto — Derivatives & On-Chain

Tool Description Price
get_crypto_pulse OI top 10, funding rates, Fear & Greed $0.03
get_crypto_options BTC/ETH options: OI by exchange, put/call ratios $0.03
get_crypto_exchange_flows Exchange balance flows for BTC/ETH $0.03
get_crypto_etf_flows BTC/ETH spot ETF fund flows (IBIT, FBTC, GBTC...) $0.10
get_whale_alerts On-chain whale transactions (USDT, USDC, WBTC, ETH) $0.05
get_crypto_oi_history Open interest OHLC history (30 days) $0.05
get_crypto_funding_history Funding rate OHLC history (30 days) $0.05

Bitcoin On-Chain

Tool Description Price
get_btc_on_chain_overview MVRV, SOPR, realized price, Coinbase Premium, SSR, MPI $0.12
get_btc_mvrv Market Value to Realized Value with 30-day history $0.05
get_btc_sopr Spent Output Profit Ratio (SOPR, aSOPR, STH, LTH) $0.05
get_btc_realized_price Realized price with 30-day history $0.03
get_btc_coinbase_premium Coinbase Premium Index (US buying pressure) $0.03
get_btc_exchange_reserve Exchange reserve with 30-day history $0.03
get_btc_exchange_netflow Exchange netflow (accumulation vs distribution) $0.03
get_btc_ssr Stablecoin Supply Ratio (buying power indicator) $0.03
get_btc_mpi Mayer Multiple / MPI (valuation) $0.03
get_btc_leverage_ratio Estimated leverage ratio (speculation gauge) $0.03
get_btc_etf_premium ETF Premium (IBIT, GBTC) vs NAV $0.05

Market & Macro

Tool Description Price
get_market_briefing Complete market briefing: regime + smart money + crypto $0.10
get_macro_dashboard Market regime, cross-asset signals, FRED indicators $0.10
get_earnings_calendar Upcoming/recent earnings with EPS estimates & surprise % $0.05
get_market_regime Green/Yellow/Red via VIX + SPY MA + credit spreads FREE
get_crypto_fear_greed Crypto Fear & Greed with 90-day history + BTC correlation FREE

Discovery Endpoints

Endpoint Description
meridianfin.io/llms.txt LLM-readable service description
meridianfin.io/api/openapi.json OpenAPI 3.1 spec with x402 pricing
meridianfin.io/api/health Service health + capabilities
meridianfin.io/api/stats Data freshness + source info

Example Usage

Ask your AI assistant:

  • "What are Congress members trading this week?"
  • "Show me dark pool anomalies with Z-score above 2"
  • "Get the BTC on-chain overview — is it bullish?"
  • "Which stocks have multi-source smart money confluence?"
  • "What's the market regime right now?"

Data Sources

  • SEC EDGAR — Form 4 (insider), 13F (institutional), 13D/G (activist)
  • STOCK Act — Congress trading disclosures
  • FINRA — Dark pool, short interest
  • ARK Invest — Daily trade notifications
  • Dataroma — Superinvestor portfolio tracking
  • CryptoQuant / CoinGlass — On-chain & derivatives data
  • Yahoo Finance / FRED — Macro indicators

Links

License

MIT

About

MCP Server for Meridian — smart money signals, crypto on-chain, macro intelligence. 34 tools via hosted endpoint.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors