Bull Vision Agent

What is Bull Vision Agent?

Bull Vision Agent is a FastAPI application that integrates Telegram webhooks with OpenAI Agents SDK to provide AI-powered stock trading assistance. It manages multiple MCP servers via MCPHub for tasks like stock news analysis and volume wall detection.

How to use Bull Vision Agent?

Clone the repository, install dependencies with poetry install, copy .env.example to .env and fill in required credentials (Telegram bot token, Azure OpenAI key, MongoDB URI), then start the server with make run. The bot responds to commands like /start and /help, and users can ask natural language queries about stocks, news, and trading strategies.

Key features of Bull Vision Agent

• Telegram bot integration with webhook support
• AI-powered stock analysis using OpenAI Agents SDK
• Stock news analysis via MCP server
• Volume wall detection via MCP server
• Real-time stock data analysis
• MongoDB integration for data persistence

Use cases of Bull Vision Agent

• Analyze a stock (e.g., "Analyze AAPL")
• Get latest market news (e.g., "What's the latest news about Tesla?")
• Ask for trading strategies (e.g., "What's your view on the current market?")
• Check volume patterns (e.g., "Check volume patterns for MSFT")

FAQ from Bull Vision Agent

What dependencies does Bull Vision Agent require?

It requires Python dependencies installed via Poetry, a Telegram bot token from @BotFather, an Azure OpenAI API key and endpoint, and a MongoDB connection string.

How does Bull Vision Agent receive messages from Telegram?

It uses a webhook endpoint at /api/telegram/webhook. The webhook URL must be publicly accessible and is automatically registered on startup.

Where does conversation data and persistence happen?

Conversation history, trading context, and other data are stored in a MongoDB database configured via the MONGO_URI environment variable.

What MCP servers does Bull Vision Agent integrate with?

It manages multiple MCP servers via MCPHub, including servers for stock news analysis and volume wall detection.

How do I set up the Azure OpenAI credentials?

You must set AZURE_OPENAI_API_KEY, AZURE_OPENAI_ENDPOINT, AZURE_OPENAI_DEPLOYMENT, and AZURE_OPENAI_API_VERSION in the .env file.