Borsa MCP
An MCP server with Turkish and US market data: stocks, TEFAS funds, crypto, currencies and central bank statistics
- 660 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Requests go to the author's server and to external sources: Yahoo Finance, KAP, TEFAS, BtcTurk, Coinbase
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/borsa-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Requests go to the author's server and to external sources: Yahoo Finance, KAP, TEFAS, BtcTurk, Coinbase
This is third-party code. Review the repository files before installing.
What it does
Borsa MCP gives an agent Turkish and US financial data through more than twenty tools. Borsa Istanbul and US stocks are queried with the same tools, and the market is set by the market parameter. For each security there are a company profile, quick metrics, price history, technical analysis, pivot points, dividends, financial statements and news from the KAP disclosure platform. Separate tools cover a stock scanner on technical indicators and a screener with ready presets, indices, TEFAS funds with comparison, BtcTurk and Coinbase pairs, currency and metal rates, an economic calendar for seven countries and bond yields. Central Bank of Turkey data includes inflation and a purchasing-power calculator, and thousands of macro series are reachable through EVDS. You can use it with no installation: the server is hosted by the project author. The same code also runs locally with `uvx`. Example requests from the documentation: a month of performance for the GARAN stock, the state of the XU100 index, the price of Bitcoin in lira.
Who it is for. For analysts, traders and private investors who follow the Turkish and US markets and want to ask about quotes, funds and macro indicators in plain language.
Good fit when
- You want to analyze a Borsa Istanbul stock's month with technical indicators
- You want to compare TEFAS funds by return and portfolio composition
- You need the Bitcoin rate in lira and a comparison of BTCTRY on BtcTurk with BTC-USD on Coinbase
- You need to recalculate the purchasing power of the lira over a period using Turkish central bank inflation data
- You are planning your week and want the economic calendar for Turkey, the US and five more countries
Not a fit when
- You need trades and orders: the tool list has no buy or sell operations, the server only returns data
- You need Russian securities and ruble instruments: the server covers Turkey, the US, crypto and currencies
- You want an investment recommendation: the author warns the answers are not advice and models can make mistakes
- You need certified data for reporting: the sources are aggregated, Yahoo Finance among them, and figures must be checked against the primary source
Example request
Analyze the GARAN stock over the last month and compare it with the XU100 indexMCP
- Transport
- http, stdio
- Authentication
- not required
Environment variables
EVDS_API_KEYsecret- A free EVDS key from the Central Bank of Turkey, needed only to pull series through get_evds_data
Limitations
The cloud address belongs to the project author, and your requests pass through their server. Connecting the remote server as a custom connector in Claude Desktop requires a paid subscription. Running it yourself needs Python 3.11 or newer, Git and the `uv` manager.
To fetch data from the Central Bank of Turkey's EVDS you need a free `EVDS_API_KEY`: the catalog and series search work without it, as does inflation data from get_macro_data. The documentation is in Turkish, and part of the data concerns the Turkish market and may not suit everyone.
How to disable. In Claude Desktop, remove the Borsa MCP connector under Connectors. For a local run, delete the Borsa MCP block from `claude_desktop_config.json` and stop using the EVDS key.
FAQ
How do I connect Borsa MCP to Claude Desktop?
Open Settings, then Connectors and Add Custom Connector. Enter Borsa MCP as the name and https://borsa.surucu.dev/mcp as the URL, then click Add. Custom connectors require a paid Claude subscription. For Google Antigravity, add a block with serverUrl pointing to the same address in `mcp_config.json`.
Do I need to install anything?
No, if you use the remote address. A local run needs Python 3.11 or newer and `uv`, then the command `uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp`. In Claude Desktop it goes into `claude_desktop_config.json` under mcpServers.
Do I need a key for the Central Bank of Turkey data?
Only to pull EVDS series through get_evds_data: you get a free key in your account at evds3.tcmb.gov.tr and set it in the `EVDS_API_KEY` variable. The catalog, series search and inflation through get_macro_data work without a key.
Can the agent trade through Borsa MCP?
No. The tools include no orders, buying or selling: the server returns quotes, financial statements, funds and macro data. The author stresses the answers are not investment advice and that figures from the model must be verified.
Where does the data come from?
From KAP, Yahoo Finance, BtcTurk, Coinbase, the borsapy package, TEFAS and the Central Bank of Turkey. News comes from the KAP disclosure platform, and Mynet Finans adds shareholder structure and index composition data.
Discussion
No questions or reviews yet.
Related
MCP serversFinancial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
MOEX and T-Bank Invest market data MCP
market-mcp
A read-only MOEX ISS and T-Bank Invest market data MCP server: quotes, candles, a screener, and optional portfolio access
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
Finmap MCP server with exchange data, including MOEX
Finmap MCP Server
An MCP server with historical data from eight exchanges, including Moscow: sectors, tickers, market cap, trading volume and treemap visualizations
Twelve Data MCP connects an assistant to a market data API: quotes, historical prices, indicators, fundamentals and company news.
T-Bank Invest MCP server, read-only
T-Bank Invest MCP Server (read-only)
An MCP server for a T-Bank Invest portfolio with no trading rights: positions, operations, market data, and technical and fundamental analytics
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Borsa MCP (this card) | no | not required | 660 | |
| Financial Datasets MCP | yes | API key | 2,326 | focused on US companies: financial statements, stock and crypto prices and news through the Financial Datasets API |
| MOEX and T-Bank Invest market data MCP | no | key is optional | 0 | read-only market data from the Moscow Exchange and T-Invest |
README in short
The Turkish documentation opens with a quick start using the remote address, then lists the capabilities: stocks on two markets, technical scanners, EVDS, macro data, funds, crypto, currencies and an economic calendar. Next come sections on local setup for the 5ire client and Claude Desktop, tool tables by group, a description of data sources and a long list of example requests.