Overview

Borsacı is an AI agent that accesses and analyzes Turkish financial market data using the Borsa MCP server. It is developed for educational and research purposes.

Features

43 Financial Tools: Full market access through Borsa MCP integration
Multi-Agent Architecture: Task planning, execution, validation, and response synthesis
Parallel Task Execution: 50-70% performance improvement with dependency-aware parallelization
Terminal Visualizations: ANSI-colored candlestick charts with plotext
Conversation History: Context-preserved follow-up questions support
Auto-Update: GitHub commit-based automatic updates
Turkish Natural Language: Fully Turkish commands and outputs
Type-Safe Design: Runtime validation with PydanticAI framework
Advanced LLMs: Google Gemini 2.5 Series (Pro + Flash models)

Installation

Docker (Recommended)

git clone https://github.com/saidsurucu/borsaci.git
cd borsaci
cat > .env << EOF
OPENROUTER_API_KEY=sk-or-v1-your-api-key-here
EOF
docker-compose run --rm borsaci

Manual Installation

git clone https://github.com/saidsurucu/borsaci.git
cd borsaci
uv sync
uv run borsaci

Usage Examples

Basic Queries

>> What is ASELS stock's last quarter revenue growth?
>> Bitcoin TRY price and 24-hour change?
>> List the top 5 performing A-type mutual funds

ASELS is Aselsan (Turkish defense company), similar to Lockheed Martin in the US market. A-type funds are equity-focused mutual funds in Turkey's TEFAS (Electronic Fund Distribution Platform).

Chart Visualization

>> ASELS 1-week candlestick chart
>> Show THYAO candlestick chart

THYAO is Turkish Airlines' stock ticker on Borsa Istanbul.

Follow-up Questions

>> Tell me about ASELS stock
>> elaborate
>> should I buy?

Parallel Queries

>> ASELS THYAO GARAN EREGL SAHOL latest prices
>> Gold, dollar, euro, bitcoin prices

GARAN is Garanti Bank, EREGL is Ereğli Iron & Steel, SAHOL is Sabancı Holding - major blue-chip stocks on Borsa Istanbul (BIST).

⚠️ Important Disclaimer

Not Investment Advice: This is purely an educational and research project. The information provided does not constitute financial advice, professional consultation, or buy/sell recommendations, and should never influence real investment decisions.

License

MIT License

Borsacı