investor-agent is a Model Context Protocol (MCP) server for building investor agents, positioned as a financial research tool for long-term investors. It provides stock market data, including options recommendations and other content, to compatible AI clients through the MCP protocol, enabling AI assistants to assist with investment research based on this data.
Main capabilities: As an MCP server, it exposes financial research-related data interfaces to clients, specifically covering stock market data and options recommendations. The project description summarizes it as a "financial research MCP server for long-term investors."
Usage: The project provides two operating modes.
-
Hosted remote MCP: The official project runs a hosted instance on Cloudflare Workers, at the address https://investor.ferdousbhai.com/mcp，采用 Streamable HTTP transport, no authentication required. It can be used in MCP client configurations that support remote servers, such as Claude Code.
-
Local stdio mode (built from source): The project is not published to npm, and the official documentation explicitly states not to run npx investor-agent, because nothing published under that npm name belongs to this project. The correct approach is to build from the repository, then point the client to the built entry point.
In addition, the project also supports self-deployment to Cloudflare Workers: the server can also run as a remote MCP server on Workers (source code located at src/worker.ts), and the cloudflare.config.ts in the repository can be deployed directly using the cf CLI. After deployment is complete, you can point the client to https://investor-agent.<your-subdomain>.workers.dev/mcp, or bind a custom domain in the Cloudflare dashboard.
Use cases: Suitable for long-term investors, financial researchers who need to integrate stock market data and options recommendations into AI workflows, and developers who want to build investment research agents based on MCP.
Limitations and notes: The project is not published to npm and cannot be installed via npx; the hosted instance requires no authentication, but self-deployment requires a Cloudflare Workers environment and the cf CLI; details such as the specific supported data fields, call rate limits, data accuracy, or timeliness are not yet provided in the materials.
