# Finage — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/finage

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_finage?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/finage/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/finage/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/finage/skill.md
Postman collection (v2.1): https://mcp.ai/finage/postman.json

## Tools
- finage_convert_crypto(amount: number, to_currency: string, from_currency: string) — 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).
- finage_convert_currency(amount: number, to_currency: string, from_currency: string) — 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.
- finage_get_bonds_rate(symbol: string) — 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
- finage_get_country_detail(country_code: string) — 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.
- finage_get_crypto_aggregates(sort?: string, time: string, limit?: integer, symbol: string, to_date: string, multiply: integer, from_date: string) — 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
- finage_get_crypto_detail(key: string) — 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
- finage_get_crypto_detailed(symbol: string) — 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
- finage_get_crypto_last_quote(symbol: string) — 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.
- finage_get_crypto_last_trade(symbol: string) — 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.
- finage_get_crypto_news(limit?: integer, symbol: string) — 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
- finage_get_crypto_previous_close(symbol: string) — 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,
- finage_get_crypto_snapshot(quotes?: boolean, trades?: boolean, symbols?: string) — 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
- finage_get_currency_detail(symbol: string) — 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
- finage_get_forex_last_quote(symbol: string) — 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.
- finage_get_forex_last_trade(symbol: string) — 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.
- finage_get_forex_market_aggregates(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) — 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
- finage_get_forex_news(symbol: string) — 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.
- finage_get_forex_previous_close(symbol: string) — 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,
- finage_get_forex_snapshot(quotes?: boolean, trades?: boolean, symbols?: string) — 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
- 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.
- 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.
- 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.
- finage_get_stock_company_details(symbol: string) — 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
- finage_get_stock_historical_data(sort?: string, limit?: integer, symbol: string, to_date: string, from_date: string, time_unit?: string, multiplier?: integer, unadjusted?: boolean) — 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
- finage_get_stock_last_quote(symbol: string, timestamp_type?: string) — 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 
- finage_get_stock_last_trade(symbol: string) — 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.
- finage_get_stock_market_aggregates(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) — 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
- finage_get_stock_market_news(limit?: integer, symbol: string) — 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
- finage_get_stock_market_status(country?: string, holidays?: boolean, currencies?: boolean, trading_hours?: boolean, extended_hours?: boolean) — 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
- finage_get_stock_previous_close(date?: string, symbol: string, unadjusted?: boolean) — 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
- finage_get_stock_snapshot(quotes?: boolean, trades?: boolean, symbols?: string) — 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.
- finage_get_technical_indicators(period?: integer, symbol: string, time_interval: string, indicator_type: string) — 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 (
- 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 
- 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 
- finage_list_cryptocurrencies(page?: integer, sort?: string, limit?: integer) — 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
- finage_list_symbols(page?: integer, type: string, search?: string) — 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
- finage_search_country(key: string, limit?: integer) — 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
- finage_search_cryptocurrency(key: string, limit?: integer) — 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.
- finage_search_currency(key: string, limit?: string) — 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
- finage_search_market(key: string, limit?: integer, market: string) — 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

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

## Links
Docs: https://mcp.ai/docs/mcps/finage
Website: https://mcp.ai/mcps/finage