home / mcp / borsa mcp server

Borsa MCP Server

Provides access to BIST, US stocks, TEFAS funds, crypto, forex, and macro data for analysis and screening via MCP clients.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "saidsurucu-borsa-mcp": {
      "url": "https://borsamcp.fastmcp.app/mcp"
    }
  }
}

You can access Borsa MCP to perform fast, multi-source financial analysis through an MCP client. It provides up-to-date data on BIST, US markets, TEFAS funds, crypto, forex, and commodities, enabling you to run in-depth analyses, screening, and cross-market comparisons with ease.

How to use

Connect to the MCP server using your MCP client or environment that supports remote MCP URLs. Use the remote MCP address to add a new MCP server entry in your client. Once connected, you can request data and analyses across BIST stocks, US equities, TEFAS funds, crypto pairs, and macro data. Typical tasks include screening, price and fundamental checks, historical period analyses, pivot points, and cross-market comparisons. You can ask for specific questions like a stock’s latest performance in a date range, a market index’s recent trend, or a cross-market price comparison between Turkish and global crypto prices.

If you work from a browser-enabled agent or editor with MCP support, you can view the configured MCP server and run analytics in-session without local setup. For example, you can look up a company’s balance sheet, pull historical OHLCV data with a custom date range, generate quick metrics like ROE or P/E, and run pivot point calculations directly within your workflow.

How to install

Prerequisites You should have a modern Node.js and/or Python environment if you plan to run local MCP clients. Installations shown here cover remote usage and local setup options that are explicitly described in the guidance.

Step 1. Use the remote MCP (no installation required) Open your MCP client and connect using the remote MCP URL: https://borsamcp.fastmcp.app/mcp

Step 2. Optional local setup via 5ire (for local hosted MCP client) Install required tooling and the local MCP toolchain as described below, then configure the local MCP tool to point to this server.

Step 3. Optional local setup via Claude Desktop (for local hosted MCP) Configure Claude Desktop to load the local Borsa MCP tool using the provided command, then restart Claude Desktop to apply changes.

Configuration and connection methods

Remote MCP connection (HTTP) The primary connection method is a remote HTTP MCP server. Use this to access the MCP server without any local installation.

Local MCP via 5ire The local method uses uvx to fetch and run the MCP package from GitHub. This requires you to have uvx installed and available in your PATH.

Local MCP via Claude Desktop You can wire Claude Desktop to a local MCP runner by editing the Claude config to reference the uvx-based local tool. Restart Claude Desktop after saving the config.

Examples of common tasks

Analyze the last 1 month performance of a BIST stock such as GARAN and compare with XU100.

Query the latest price of Bitcoin in TRY or USD and track a 1-month window.

Fetch TEFAS fund performance, portfolio distribution, and compare multiple funds.

Available tools

find_ticker_code

Searches for ticker codes among current BIST-listed companies to identify the exact symbol to use in analyses.

get_sirket_profili

Retrieves detailed company profiles, including business description and key identifiers.

get_bilanco

Fetches annual or quarterly balance sheet data for companies.

get_kar_zarar_tablosu

Provides the income statement data on a annual or quarterly basis.

get_nakit_akisi_tablosu

Returns cash flow statements for periods of interest.

get_finansal_veri

Pulls historical OHLCV data for stocks and indices, with optional date ranges.

get_analist_tahminleri

Returns analyst recommendations and price targets to gauge market sentiment.

get_temettu_ve_aksiyonlar

Shows dividend history and corporate actions for securities.

get_hizli_bilgi

Provides quick access to key metrics such as P/E, P/B, and ROE.

get_kazanc_takvimi

Fetches earnings calendars and growth data for companies.

get_teknik_analiz

Delivers comprehensive technical analysis and indicators.

get_pivot_points

Calculates daily pivot points with 3 resistance and 3 support levels.

get_sektor_karsilastirmasi

Compares sectors to identify relative performance across markets.

get_kap_haberleri

Retrieves the latest KAP news and official company announcements.

get_kap_haber_detayi

Returns detailed KAP news content in Markdown format.

get_endeks_kodu

Finds codes for current BIST indices in the index list.

get_endeks_sirketleri

Lists the companies contained in a specific BIST index.

screen_bist_stocks

Filters BIST stocks with 15 presets or 50+ custom filters for advanced screening.

get_bist_screener_presets

Provides the existing 15 presets with descriptions (e.g., high_dividend, low_pe, high_roe).

get_bist_screener_filters

Documents custom filter fields and operators for BIST screening.

search_funds

Searches TEFAS or fund universes and returns fund details.

get_fund_detail

Provides comprehensive fund information and analytics.

get_fund_performance

Gathers fund performance history via TEFAS APIs.

get_fund_portfolio

Shows fund portfolio allocations using TEFAS allocation data.

compare_funds

Compares multiple funds using TEFAS official comparison API.

get_katilim_finans_uygunluk

Checks Sharia-compliance suitability and related indices.

calculate_buffett_value_analysis

Performs Buffett-style value metrics in a single call to yield an overall rating.

calculate_core_financial_health

Returns consolidated health score using primary metrics like ROE, ROIC, leverage, and FCF margins.

calculate_advanced_metrics

Computes advanced risk and stability metrics such as Altman Z-score and inflation-adjusted growth.

calculate_comprehensive_analysis

Delivers a full 11-metric financial health assessment across liquidity, profitability, and valuation.

search_us_stock

Searches US companies across major exchanges (S&P 500, Nasdaq, NYSE).

get_us_company_profile

Gets profiles for US-listed companies.

get_us_quick_info

Provides quick US metrics like P/E, P/B, and ROE.

get_us_stock_data

Returns historical OHLCV data for US stocks.

get_us_analyst_ratings

Fetches US analyst ratings and price targets.

get_us_dividends

Retrieves US dividend histories.

get_us_earnings

Fetches US earnings calendars.

get_us_technical_analysis

Delivers US-specific technical indicators.

get_us_pivot_points

Calculates pivot points for US markets.

get_us_balance_sheet

US balance sheet data (annual/quarterly).

get_us_income_statement

US income statements (annual/quarterly).

get_us_cash_flow

US cash flow statements.

calculate_us_buffett_analysis

Buffett-style value analysis for US stocks.

calculate_us_core_health

US financial health metrics consolidation.

calculate_us_advanced_metrics

US-specific Altman Z-score and inflation-adjusted growth.

calculate_us_comprehensive

US-focused 11-metric comprehensive health analysis.

get_us_sector_comparison

Compares US sectors by key metrics.

get_us_index_search

Searches among 28 US indices.

get_us_index_info

US index details and performance data.

screen_us_securities

Screener for US stocks, ETFs, and funds with 23 presets or custom filters.

get_us_screener_presets

Lists preset names for US screening with explanations.

get_us_screener_filters

Docs for US screener filter fields and operators.

search_funds_us

Searches US funds with performance and allocations.