investor-agent
Author: ferdousbhai
Description: A Financial Analysis MCP server providing ticker, options, historical data, statements, ownership, sentiment, and technical-analysis endpoints for LLMs.
Stars: 225
Forks: 33
License: MIT License
Category: Open Source
Overview
Installation
1. Clone the repository:
git clone https://github.com/ferdousbhai/investor-agent.git
cd investor-agent2. Create and activate a virtual environment (recommended):
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate3. Install the Python dependencies:
pip install -r requirements.txt4. (Optional) Copy the example environment file and add your keys/secrets:
cp .env.example .env
# Edit .env to include any API keys (e.g., OPENAI_API_KEY) or broker credentials5. Run database migrations or initialise any local storage if the project supplies a script such as:
python manage.py migrate # or a custom script noted in README6. Start the MCP server:
python -m investor_agent.server # or the entry-point defined in README7. Verify the server is running by opening http://localhost:8000/health or similar health-check endpoint.
License: MIT License
Updated 7/30/2025