Borsa
Provides comprehensive access to Turkish and US financial markets data including BIST stocks, US equities, TEFAS funds, cryptocurrencies, forex, and commodities through 72 tools with technical analysis, financial statements, and Buffett-style value i
What is Borsa?
Borsa is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides comprehensive access to turkish and us financial markets data including bist stocks, us equities, tefas funds, cryptocurrencies, forex, and commodities through 72 tools with technical analysi...
Provides comprehensive access to Turkish and US financial markets data including BIST stocks, US equities, TEFAS funds, cryptocurrencies, forex, and commodities through 72 tools with technical analysis, financial statements, and Buffett-style value i
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides comprehensive access to Turkish and US financial ma
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx borsa-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Borsa
Borsa MCP is a Python-based MCP server providing comprehensive access to Turkish and US financial market data through 28 tools, including BIST stocks, US equities, TEFAS mutual funds, cryptocurrencies, forex rates, bond yields, and commodities. It supports technical analysis, pivot points, financial statements, analyst recommendations, dividend history, economic calendars, and Buffett-style value investing metrics. Investors and analysts use it to query both Turkish and US markets in natural language through Claude, enabling portfolio research, stock screening, and macro analysis without leaving their AI chat interface.
Prerequisites
- Python 3.10 or later with uv or pip installed
- uvx available (install via: pip install uv) for running directly from GitHub
- An MCP-compatible client such as Claude Desktop
- EVDS API key from the Central Bank of Turkey (optional, required only for macro data via get_evds_data tool)
Install uv (if not already installed)
Borsa MCP is installed via uvx, which is part of the uv Python package manager. Install uv first if you don't have it.
pip install uvTest the server with uvx
Verify the server runs correctly by launching it directly with uvx from the GitHub repository. Press Ctrl+C to stop after verifying it starts.
uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcpObtain an EVDS API key (optional)
For Turkish macroeconomic data (inflation, interest rates, etc.), register at evds2.tcmb.gov.tr and generate a free API key. This is only needed for the get_evds_data and get_macro_data tools.
Configure Claude Desktop
Add Borsa MCP to your Claude Desktop configuration file. The EVDS_API_KEY is optional — omit the env block if you don't need macro data.
{
"mcpServers": {
"borsa-mcp": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/saidsurucu/borsa-mcp",
"borsa-mcp"
],
"env": {
"EVDS_API_KEY": "your-evds-api-key-here"
}
}
}
}Alternative: Use the hosted remote MCP endpoint
If you prefer not to run the server locally, connect to the hosted FastMCP endpoint. Add it to Claude Desktop using the remote URL instead.
{
"mcpServers": {
"borsa-mcp-remote": {
"url": "https://borsamcp.fastmcp.app/mcp"
}
}
}Restart Claude Desktop and start querying
Fully quit and relaunch Claude Desktop. You can now ask about Turkish BIST stocks, US equities, crypto prices, forex rates, and more.
Borsa Examples
Client configuration
Claude Desktop config for Borsa MCP running locally via uvx with optional EVDS API key for macro data.
{
"mcpServers": {
"borsa-mcp": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/saidsurucu/borsa-mcp",
"borsa-mcp"
],
"env": {
"EVDS_API_KEY": "your-evds-api-key-here"
}
}
}
}Prompts to try
Example queries for Turkish and US financial market analysis through Claude.
- "Analyze GARAN's stock performance over the last month and give me technical analysis."
- "Show me today's XU100 (BIST 100 index) status and top gainers."
- "What is the current USD/TRY exchange rate and how has it moved today?"
- "Analyze Apple (AAPL) stock's last 3 months and show analyst recommendations."
- "Screen BIST stocks with P/E ratio under 10 and dividend yield above 5%."
- "Get the latest Bitcoin price in Turkish Lira."Troubleshooting Borsa
uvx command not found when starting the server
Install uv with 'pip install uv' and ensure ~/.local/bin (or the uv bin path) is in your PATH. Restart your terminal after installation and verify with 'uvx --version'.
get_evds_data returns authentication errors
Verify your EVDS_API_KEY is correct by testing it directly at evds2.tcmb.gov.tr. Keys are associated with your registered email. Ensure the key is set as the EVDS_API_KEY environment variable in your Claude Desktop config.
Stock data appears stale or returns no data
BIST data is only available during Turkish market hours (10:00–18:00 Istanbul time, weekdays). US equity data follows NYSE/NASDAQ hours. Crypto and forex data is available around the clock. If data is consistently missing, the underlying data provider API may be temporarily unavailable.
Frequently Asked Questions about Borsa
What is Borsa?
Borsa is a Model Context Protocol (MCP) server that provides comprehensive access to turkish and us financial markets data including bist stocks, us equities, tefas funds, cryptocurrencies, forex, and commodities through 72 tools with technical analysis, financial statements, and buffett-style value i It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Borsa?
Follow the installation instructions on the Borsa GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Borsa?
Borsa works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Borsa free to use?
Yes, Borsa is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Borsa Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Borsa? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Borsa in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Borsa?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.