Overview
What is Okevinok?
Okevinok is a Model Context Protocol (MCP) server that provides stock market data from the Alpha Vantage API. It enables Claude and other MCP clients to access real-time and historical stock data. The server requires Node.js 16 or higher and a free Alpha Vantage API key.
How to use Okevinok?
Clone the repository, run npm install, add your Alpha Vantage API key to a .env file, then build with npm run build and start with npm start. For use with Claude for Desktop, add a configuration entry to claude_desktop_config.json specifying the command node with the path to the built index.js and the API key as an environment variable.
Key features of Okevinok
- Retrieve intraday stock data with customizable intervals
- Obtain daily stock data for any symbol
- Generate stock alerts based on price movement thresholds
- Access stock data directly as MCP resources
Use cases of Okevinok
- Monitor real‑time or historical stock prices within an AI assistant
- Analyze intraday and daily price trends for investment research
- Set up automated price alerts on significant percentage moves
- Integrate stock data into Claude’s context for financial queries
FAQ from Okevinok
What API key is required?
A free Alpha Vantage API key is required, obtainable at Alpha Vantage. It is set in the environment variable ALPHA_VANTAGE_API_KEY.
What tools does Okevinok expose?
Three tools: get-stock-data (intraday), get-daily-stock-data, and get-stock-alerts. Each accepts a symbol (required) and optional parameters like interval and outputsize.
How is stock data accessed as resources?
A single resource stock-data uses the URI template stock://{symbol}/{interval}. Supported intervals include daily, 1min, 5min, 15min, 30min, and 60min.
What runtime and dependencies are needed?
Node.js 16 or higher, and the project’s npm dependencies (installed via npm install). The server is written in TypeScript and must be built before running.
Is there a transport or authentication outside the API key?
No. The server runs locally via stdio transport for MCP. The only authentication is the Alpha Vantage API key passed as an environment variable.
