Back

API & MCP Tools

40 tools available through the Model Context Protocol. Connect once, access everything. Each tool returns structured Pydantic models — no raw dictionaries, no wrapper types.

Connect

Claude Code

claude mcp add meridex \
  --transport http \
  https://your-server:8000/mcp \
  --header "X-API-Key: mop_..."

Claude Desktop

{
  "mcpServers": {
    "meridex": {
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "env": {
        "MOP_API_KEY": "mop_..."
      }
    }
  }
}

REST API

curl -H "X-API-Key: mop_..." \
  https://your-server:8000/\
  v1/api/market/get_ticker_snapshot\
  ?ticker=AAPL

Real-Time Snapshots

6 tools
market_get_ticker_snapshot

Real-time snapshot for a single ticker — quote, last trade, day and minute bars.

market_get_snapshot_all_tickers

Real-time snapshot for every ticker in a given market.

market_list_universal_snapshots

Multi-asset snapshot across stocks, options, crypto, and forex in one call.

market_get_top_movers

Top 20 gainers and losers for the day, ranked by percentage change.

market_get_previous_close

Previous trading day's open, high, low, close, and volume.

market_get_daily_open_close

Single day OHLCV with pre-market and after-hours data.

Historical Bars

3 tools
market_get_aggregate_bars

OHLCV bars with custom timeframes — minute, hour, day, week, month, quarter, year.

market_list_aggregate_bars

Same as above with automatic pagination for large date ranges.

market_get_grouped_daily_bars

Entire market's OHLCV for a single date. Every ticker, one call.

Technical Indicators

4 tools
market_get_sma

Simple Moving Average for identifying trends over a configurable window.

market_get_ema

Exponential Moving Average. More responsive to recent price changes than SMA.

market_get_rsi

Relative Strength Index on a 0-100 scale. Above 70 is overbought, below 30 is oversold.

market_get_macd

MACD line, signal line, and histogram for momentum analysis and crossover detection.

Options & Derivatives

3 tools
market_get_options_contract

Full options contract specifications — strike, expiration, exercise style, and Greeks.

market_list_options_contracts

Options chain with filtering by underlying, expiration date, and strike price.

market_get_crypto_order_book

Level 2 cryptocurrency order book with bids, asks, and market depth.

Company Intelligence

5 tools
market_get_ticker_details

Company fundamentals — market cap, SIC code, description, address, employee count.

market_get_ticker_events

Corporate timeline including name changes, mergers, and delistings.

market_get_ticker_types

Valid ticker type codes (CS, ETF, ADRC, etc.) with descriptions.

market_list_tickers

Search and browse tickers by symbol or name. Supports text search.

market_get_related_companies

Peer companies, competitors, and sector mates for a given ticker.

Corporate Actions

4 tools
market_list_dividends

Cash dividend events with ex-date, record date, pay date, and amounts.

market_list_stock_dividends

Stock dividends — distributions in shares rather than cash.

market_list_splits

Stock split events with execution dates and split ratios.

market_list_stock_splits

Alternative stock split endpoint with different filtering options.

Short Interest & Float

3 tools
market_list_short_interest

Short interest percentage and volume for a given ticker.

market_list_short_volume

Daily short sale volume compared to total trading volume.

market_list_float_shares

Public float data — the number of freely tradeable shares outstanding.

Macro & Fixed Income

4 tools
market_list_inflation

Historical US inflation data from the Federal Reserve, CPI-based.

market_list_inflation_expectations

Forward-looking inflation expectations from the Fed.

market_list_labor_market

Employment statistics — unemployment rate, employment figures, job openings.

market_list_treasury_yields

US Treasury yield curve across maturities: 2Y, 5Y, 10Y, 30Y, and more.

Risk & Regulatory

2 tools
market_list_risk_factors

Risk factors extracted from SEC filings — 10-K and 10-Q reports.

market_list_risk_factor_taxonomies

Risk factor categorization system for systematic analysis across filings.

News

1 tool
market_list_ticker_news

News articles with headlines, URLs, publisher information, and tickers mentioned.

Market Reference

3 tools
market_get_exchanges

Stock exchange list with name, MIC code, locale, and asset class metadata.

market_get_market_status

Current market state — open, closed, pre-market, or after-hours.

market_get_market_holidays

US stock market holidays with open/close schedules.

Diagnostics

2 tools
market_healthcheck

Verify the MCP server is running and responsive.

market_validate_config

Validate that the API key is configured correctly. No network call.