Borsacı

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