# Finage — how to use (mcp.ai)

Connect your Finage account and use 40 tools for analytics straight from your AI agent. Connect with your own API key. Finage provides secure RESTful APIs for real-time and historical financial market data covering stocks, forex, cryptocurrencies, indices, ETFs, and commodities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_finage?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `finage_convert_crypto`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/finage`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/finage/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/finage/convert/crypto` — Tool to convert cryptocurrencies using real-time exchange rates from the Finage API. Use when you need to convert between different cryptocurrencies (e.g., BTC to ETH, USD to DOGE, SHIB to BTC).
  - body: { amount: number, to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/finage/convert/currency` — Tool to convert currencies using real-time forex exchange rates from Finage API. Use when you need to convert an amount from one currency to another with current market rates.
  - body: { amount: number, to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/finage/get/bonds/rate` — Retrieve the current interest rate for a US Treasury bond by maturity. Returns the Federal Reserve's constant maturity Treasury (CMT) rate as a percentage. Useful for tracking benchmark interest rates
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/country/detail` — Tool to retrieve detailed information about a country including currency, phone code, and flag. Use when you need country metadata for financial or geographical context.
  - body: { country_code: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/aggregates` — Tool to retrieve aggregated OHLCV time-series data for cryptocurrency pairs over specified time periods. Use when you need historical tick bars (candlestick data) for crypto trading pairs with customi
  - body: { sort?: string, time: string, limit?: integer, symbol: string, to_date: string, multiply: integer, from_date: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/detail` — Tool to get detailed fundamental information about a cryptocurrency including description, developers, website, social media links, and technical details. Use when you need comprehensive background in
  - body: { key: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/detailed` — This tool fetches detailed cryptocurrency information including current price, price changes, volume, market cap, and historical highs/lows for a specific cryptocurrency pair. Use when comprehensive c
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/last/quote` — Tool to get the last quote with bid/ask prices in real-time for a cryptocurrency pair. Use when you need current market data for crypto trading pairs including bid/ask spreads and order sizes.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/last/trade` — Tool to get the latest trade information and prices in real-time for a cryptocurrency pair. Use when you need current pricing data for cryptocurrencies like Bitcoin, Ethereum, or other digital assets.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/news` — Tool to retrieve real-time and historical news for cryptocurrency markets with fast In-Memory Cache Engine. Use when you need crypto market news, updates on cryptocurrencies, or research on crypto tre
  - body: { limit?: integer, symbol: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/previous/close` — Tool to get the previous day's closing data for a cryptocurrency pair. Use when you need historical end-of-day data including opening price, highest price, lowest price, closing price, trading volume,
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/crypto/snapshot` — Tool to get a comprehensive snapshot of cryptocurrency market data with latest quotes and trades in one request. Use when you need broad crypto market coverage or real-time data for multiple cryptocur
  - body: { quotes?: boolean, trades?: boolean, symbols?: string }
- `POST https://api.mcp.ai/api/finage/get/currency/detail` — Tool to get detailed information about a forex currency pair including currency codes and country flags. Use when you need to retrieve metadata about a specific currency pair such as the base and quot
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/forex/last/quote` — Tool to get the latest real-time bid/ask quote for a forex pair or metal (e.g., GBPUSD, XAUUSD). Use when you need current market data for forex trading pairs or commodities including bid/ask spreads.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/forex/last/trade` — Tool to get the last trade information for a forex currency pair. Use when you need current price data for forex trading pairs like EURUSD or GBPUSD.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/forex/market/aggregates` — Tool to retrieve aggregated OHLCV (Open, High, Low, Close, Volume) data for forex and metal pairs over specified time periods. Use when you need historical or intraday bars for forex pairs (e.g., GBPU
  - body: { et?: string, st?: string, sort?: string, time: string, limit?: integer, symbol: string, to_date: string, multiply: integer, from_date: string, dbt_filter?: boolean, date_format?: string }
- `POST https://api.mcp.ai/api/finage/get/forex/news` — Tool to retrieve real-time and historical news for forex markets from Finage's API. Use when you need forex market news, currency updates, or research on forex trends for a specific currency symbol.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/forex/previous/close` — Tool to get the previous day's closing data for a forex currency pair. Use when you need historical end-of-day data including opening price, highest price, lowest price, closing price, trading volume,
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/forex/snapshot` — Tool to get a comprehensive snapshot of forex market data with latest quotes and trades in one request. Use when you need broad forex market coverage or real-time data for multiple currency pairs simu
  - body: { quotes?: boolean, trades?: boolean, symbols?: string }
- `POST https://api.mcp.ai/api/finage/get/most/active/stocks` — Tool to get a list of the most actively traded US stocks. Use when you need to identify which stocks are experiencing the highest trading volume in the current market session.
- `POST https://api.mcp.ai/api/finage/get/sec/rss/feed` — Tool to retrieve the SEC RSS feed for recent EDGAR filings. Use when you need information about recent SEC filings including title, date, link, CIK, form type, and ticker symbol.
- `POST https://api.mcp.ai/api/finage/get/sector/performance` — Tool to retrieve performance metrics across US market sectors. Use when you need to analyze sector-level market trends or compare performance across different industries.
- `POST https://api.mcp.ai/api/finage/get/stock/company/details` — Tool to retrieve detailed company information and stock fundamentals for a given ticker symbol. Use when you need comprehensive information about a company including CEO, description, industry, sector
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/stock/historical/data` — DEPRECATED: Use FINAGE_GET_STOCK_MARKET_AGGREGATES instead. Fetches historical OHLCV (open, high, low, close, volume) data for US stocks from Finage API. Returned timestamps are UTC-aligned; non-tradi
  - body: { sort?: string, limit?: integer, symbol: string, to_date: string, from_date: string, time_unit?: string, multiplier?: integer, unadjusted?: boolean }
- `POST https://api.mcp.ai/api/finage/get/stock/last/quote` — Fetches the latest single-tick quote for a stock symbol, returning a JSON object with fields: symbol, ask, bid, asize, bsize, and timestamp. Suitable for real-time trading and market analysis. During 
  - body: { symbol: string, timestamp_type?: string }
- `POST https://api.mcp.ai/api/finage/get/stock/last/trade` — Tool to get the most recent trade information for a specified US stock symbol. Use when you need real-time price and volume data from the latest executed trade.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/finage/get/stock/market/aggregates` — Retrieves aggregated OHLCV (Open, High, Low, Close, Volume) data for US stocks only. Supports stock symbols like AAPL, MSFT, GOOGL. Does NOT support forex pairs (EUR/USD, GBP/USD), commodities (XAU/US
  - body: { sort?: string, time: string, limit?: integer, symbol: string, to_date: string, end_time?: string, multiply: integer, from_date: string, dbt_filter?: boolean, start_time?: string, unadjusted?: boolean }
- `POST https://api.mcp.ai/api/finage/get/stock/market/news` — This tool retrieves the latest market news from Finage's API. It provides comprehensive market news and updates, including news filtering by specific stock symbols, thereby supporting real-time market
  - body: { limit?: integer, symbol: string }
- `POST https://api.mcp.ai/api/finage/get/stock/market/status` — Tool to check if stock, forex, and crypto markets are open, closed, or in extended hours. Use when you need to determine current market status with optional country, holidays, and trading hours inform
  - body: { country?: string, holidays?: boolean, currencies?: boolean, trading_hours?: boolean, extended_hours?: boolean }
- `POST https://api.mcp.ai/api/finage/get/stock/previous/close` — This tool retrieves the previous day's closing data for a specific stock symbol. It provides essential trading information including the opening price, highest price, lowest price, closing price, trad
  - body: { date?: string, symbol: string, unadjusted?: boolean }
- `POST https://api.mcp.ai/api/finage/get/stock/snapshot` — Tool to get comprehensive snapshot of all US stock market data including latest quotes and trades with one single API request. Use when you need current market data for multiple stocks efficiently.
  - body: { quotes?: boolean, trades?: boolean, symbols?: string }
- `POST https://api.mcp.ai/api/finage/get/technical/indicators` — Tool to get technical indicators and signals for stocks from Finage API. Use when you need to analyze stock trends with technical indicators like moving averages (SMA, EMA, WMA), momentum indicators (
  - body: { period?: integer, symbol: string, time_interval: string, indicator_type: string }
- `POST https://api.mcp.ai/api/finage/get/top/gainers` — Tool to get list of top gaining US stocks by percentage change. Use when you need to identify the best performing stocks in the US market. Returns symbol, price, change amount, change percentage, and 
- `POST https://api.mcp.ai/api/finage/get/top/losers` — Tool to get list of top losing US stocks by percentage change. Use when you need to identify the worst performing stocks in the US market. Returns symbol, price, change amount, change percentage, and 
- `POST https://api.mcp.ai/api/finage/list/cryptocurrencies` — Tool to get a list of all available cryptocurrencies ranked by market capitalization. Use when you need to discover cryptocurrencies by market cap, find top crypto assets, or browse paginated crypto d
  - body: { page?: integer, sort?: string, limit?: integer }
- `POST https://api.mcp.ai/api/finage/list/symbols` — Tool to get a paginated list of all available symbols for a specified market type (us-stock, ca-stock, in-stock, ru-stock, forex, crypto, index). Use when you need to discover available symbols for tr
  - body: { page?: integer, type: string, search?: string }
- `POST https://api.mcp.ai/api/finage/search/country` — Tool to search for countries by name and retrieve their details including country code, currency, flag, and phone code. Use when you need to find country information based on a partial or full country
  - body: { key: string, limit?: integer }
- `POST https://api.mcp.ai/api/finage/search/cryptocurrency` — Tool to search for cryptocurrencies by name or symbol. Use when you need to find cryptocurrency information, discover available crypto symbols, or validate cryptocurrency identifiers.
  - body: { key: string, limit?: integer }
- `POST https://api.mcp.ai/api/finage/search/currency` — Tool to search for currency pairs and forex symbols by currency code or partial match. Use when you need to discover available currency pairs, find forex symbols, or search for currencies by code (e.g
  - body: { key: string, limit?: string }
- `POST https://api.mcp.ai/api/finage/search/market` — Tool to search for stocks in a specific market by company name or symbol. Use when you need to find stock symbols by partial matches, discover available stocks, or look up ticker symbols by company na
  - body: { key: string, limit?: integer, market: string }

## Example prompts
- "What can I do in Finage?"
- "Show me a summary of my Finage account"

## More
- Page: https://mcp.ai/finage
- Agent spec (llms.txt): https://mcp.ai/finage/llms.txt
- Postman collection: https://mcp.ai/finage/postman.json