compare_assets
Compare period returns across markets in one table: BIST/US stocks, gold, FX, crypto and TEFAS funds, in both TRY and USD.
LABSCO SUMMARY
It gives a BIST-focused workflow the tooling US-market investors take for granted.
The coverage is the argument: TEFAS funds, KAP disclosures, TCMB's EVDS with its 145 categories, and Islamic-compliance detail on BIST profiles are things you would otherwise gather from separate Turkish sources one at a time. compare_assets is the tool that earns its keep daily — gold, FX, a BIST stock and a fund in one table, in the currency you actually think in.
What it is
A local server with 23 tools covering BIST and US equities, crypto, TEFAS funds, Turkish government bond yields and TCMB's EVDS database: quotes, fundamentals, technicals, screening, cross-asset comparison and the economic calendar.
What you get
- Find and price an instrument — search_symbol across BIST, US, crypto and funds, get_quote with P/E, P/B and the 52-week range, batching up to 10 symbols.
- Read the fundamentals: get_profile with optional Islamic-compliance detail for BIST, plus get_financial_statements, get_financial_ratios, get_earnings, get_analyst_data and get_corporate_actions.
- Run the technicals — get_technical_analysis returns RSI, MACD, Bollinger Bands, moving averages and trend signals; scan_stocks screens BIST by indicator with a preset or a custom condition.
- Screen and compare: screen_securities carries 24 presets across value, growth, dividend and sector, and compare_assets puts BIST and US stocks, gold, FX, crypto and TEFAS funds in one table in TRY or USD.
- Cover funds properly — get_fund_data for TEFAS returns, portfolios and comparisons, screen_funds to find top performers by type, category and horizon.
- Get the macro picture: get_macro_data for Turkish TÜFE/ÜFE, US CPI-U and euro-area HICP with a purchasing-power calculation, get_bond_yields for 2Y, 5Y and 10Y Turkish government yields and a risk-free rate, get_economic_calendar for TR, US, EU, DE, GB, JP and CN.
- Reach TCMB's EVDS directly — 145 categories of macro series covering rates, FX, balance of payments, inflation and expectation surveys, with catalogue browsing and search (get_evds_data).
- Read KAP disclosures for a BIST stock, as a list or in full by news_id (get_news).
Requirements
Nothing to install for the hosted endpoint; running it locally takes Python 3.11 or newer and uv. The only key is optional: get_evds_data pulls series with a free EVDS_API_KEY from TCMB (register at evds3.tcmb.gov.tr), and its catalogue and search work without one. MIT licensed.
Setup effort
One command — uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp
USE CASES
01
Deciding whether a BIST stock is cheap
Put the price against the ratios and against the sector rather than against its own history.
02
Comparing where the money would have done better
Run the same period across asset classes and currencies in one table.
03
Finding funds worth a closer look
Screen TEFAS by category and horizon, then read the winner's portfolio.
04
Timing an entry off the technicals
Read the indicators for one name, or scan the index for the setup you want.
05
Reading the macro before a rate decision
Pull inflation, yields and the calendar together instead of from three sites.
06
Catching the disclosure that moved a stock
Read KAP for the name, and check what it paid out or issued.
23 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_analyst_data
Get analyst ratings, price targets, and buy/sell/hold recommendations. Batch support up to 10.
get_bond_yields
Get Turkish government bond yields (2Y, 5Y, 10Y) and risk-free rate for DCF calculations.
get_corporate_actions
What the company paid out or issued: dividends, stock splits, and (BIST) capital increases. Batch up to 10.
get_crypto_market
Get crypto ticker, orderbook, trades, or OHLC from BtcTurk (TRY) or Coinbase (USD).
get_earnings
Get earnings dates, EPS history, surprises, and growth estimates. Batch support up to 10.
get_economic_calendar
Get economic events for TR, US, EU, DE, GB, JP, CN with importance filter.
get_evds_data
MACRO: TCMB EVDS - 145 categories, tens of thousands of macro series (rates, FX, balance of payments, inflation, expectation surveys). Use action to browse catalog, search, fetch series, or access dashboards. Catalog and search work without a key; data fetch (series, multi_series, datagroup_data) requires EVDS_API_KEY env var (free at https://evds3.tcmb.gov.tr). Required params by action: datagroups→category_id; series_list/datagroup_data→datagroup_code; search/search_server→keyword; series/series_info→series_code; multi_series→series_codes; dashboard→dashboard_name or dashboard_id.
get_financial_ratios
Get ratios: valuation (P/E, EV/EBITDA), Buffett analysis, health metrics, or comprehensive.
get_financial_statements
Get balance sheet, income statement, and cash flow (annual/quarterly). Batch support up to 10.
get_fund_data
Get TEFAS fund info with returns (daily/weekly/1m/3m/6m/1y/3y/5y), portfolio, or compare funds. Supports custom date range.
get_historical_data
Get OHLCV price history with date range or period (1d-5y). Supports BIST, US, and crypto.
get_index_data
Get index value, change, and optionally component stocks (BIST: XU100, XU030; US: SPY, QQQ).
get_macro_data
Inflation data and cumulative purchasing-power calculation for Turkey (TÜFE/ÜFE), the US (CPI-U), or the euro area (HICP).
get_news
Get KAP news list for a BIST stock, or fetch full news content by news_id.
get_profile
Get company profile with sector, financials, key metrics, and optional Islamic compliance (BIST).
get_quote
What is it worth right now: stocks (with P/E, P/B, 52w range), currencies, metals and crypto. Batch up to 10.
get_sector_comparison
Get sector peers, average P/E and P/B, and comparative positioning for a stock.
get_technical_analysis
Get technical indicators: RSI, MACD, Bollinger Bands, moving averages, and trend signals.
scan_stocks
Scan BIST stocks by technical indicators (RSI, MACD, Supertrend, T3). Use preset or custom condition.
screen_funds
Screen and filter TEFAS funds by type, category, returns, and sort criteria. Find top performing funds.
screen_securities
Screen stocks/ETFs with 24 presets (value, growth, dividend, sector) or custom filters.
search_symbol
Search stocks, indices, funds, or crypto by name/symbol across BIST, US, crypto, and fund markets.
BEFORE YOU INSTALL
What to know first
Tools you get
23 tools when we connected.
Requires
- Python 3.11 or newer
- uv on PATH
Optional
EVDS_API_KEY in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 23 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
uvx
5ire — local
TERMINAL
uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcpHosted endpoint
ENDPOINT URL
https://borsa.surucu.dev/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Antigravity — remote
ANTIGRAVITY — REMOTE · JSON
{
"mcpServers": {
"borsa-mcp": {
"serverUrl": "https://borsa.surucu.dev/mcp",
"headers": {
"Content-Type": "application/json"
}
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"borsa": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/saidsurucu/borsa-mcp",
"borsa-mcp"
],
"env": {
"EVDS_API_KEY": "<YOUR_EVDS_API_KEY>"
}
}
}
}
