bull-vision-agent MCP Client

Use This MCP client To

Provide AI-driven stock trading advice via Telegram bot Analyze real-time stock data using multiple MCP servers Detect volume walls and analyze stock news automatically Track conversation history for personalized trading context Integrate market news into trading decision workflows Manage multiple MCP servers through a centralized client Persist trading data and context using MongoDB Enable webhook-based Telegram bot interactions for trading

README

Bull Vision Agent

A FastAPI application that integrates with Telegram using webhooks and OpenAI Agents SDK for AI-powered stock trading assistance, utilizing MCPHub for multiple MCP server management.

Features

Telegram bot integration with webhook support
AI-powered stock analysis using OpenAI Agents SDK
Multiple MCP server integration via MCPHub:
- Stock news analysis
- Volume wall detection
Real-time stock data analysis
Market news integration
Conversation history tracking
Trading context management
MongoDB integration for data persistence

Project Structure

├── app/
│   ├── __init__.py
│   ├── main.py           # FastAPI app with MCPHub initialization
│   ├── api/
│   │   ├── __init__.py
│   │   └── telegram_webhook.py  # Telegram webhook endpoint
│   ├── bot/
│   │   ├── __init__.py
│   │   ├── bot.py            # Bot instance and context management
│   │   ├── agent.py          # AI agent implementation with MCP servers
│   │   ├── context.py        # Conversation context and history
│   │   └── telegram_handler.py  # Process incoming messages
│   ├── core/
│   │   ├── __init__.py
│   │   └── settings.py   # Application settings
│   ├── models/
│   │   ├── __init__.py
│   │   └── news.py           # News data models
│   ├── services/
│   │   ├── __init__.py
│   │   └── mongodb_service.py # MongoDB operations
│   └── startup.py        # Startup events

Setup

Clone the repository
Install dependencies:
```
poetry install
```
Copy .env.example to .env and fill in the required values:
```
cp .env.example .env
```
Edit .env with your actual values:
- TELEGRAM_BOT_TOKEN: Your Telegram bot token from @BotFather
- TELEGRAM_WEBHOOK_URL: The public URL where your bot will receive updates
- HOST and PORT: Server configuration
- AZURE_OPENAI_API_KEY: Your Azure OpenAI API key
- AZURE_OPENAI_ENDPOINT: Your Azure OpenAI endpoint
- AZURE_OPENAI_DEPLOYMENT: Your Azure OpenAI deployment name
- AZURE_OPENAI_API_VERSION: Azure OpenAI API version
- MONGO_URI: MongoDB connection string
- MONGO_DB: MongoDB database name

bull-vision-agent FAQ

How does Bull Vision Agent integrate with Telegram?

It uses Telegram webhooks to receive messages and interact with users in real time.

What role does MCPHub play in Bull Vision Agent?

MCPHub manages multiple MCP servers, allowing the client to coordinate stock news analysis and volume wall detection.

How is trading context managed within the agent?

The agent tracks conversation history and trading context to provide relevant AI-powered stock insights.

What data persistence solution does Bull Vision Agent use?

It uses MongoDB to store conversation history and trading-related data persistently.

Can Bull Vision Agent analyze real-time stock data?

Yes, it integrates multiple MCP servers to analyze live stock data and market news.

Which AI SDK does Bull Vision Agent utilize?

It uses the OpenAI Agents SDK, compatible with providers like OpenAI, Anthropic Claude, and Google Gemini.

Is Bull Vision Agent limited to stock trading use cases?

While focused on stock trading, its architecture supports extension to other financial data analysis tasks.

How does the client handle multiple MCP servers?

Through MCPHub, it orchestrates communication and data flow between various MCP servers seamlessly.