stooq-mcp
A Model Context Protocol (MCP) server written in Rust that fetches stock price data from stooq.com.
Demo
https://github.com/user-attachments/assets/63b55175-80c3-42aa-a28a-bdb21c66169e
Features
Latest stock prices - Get real-time stock price data
Historical data - Retrieve historical stock data with custom date ranges
Multi-market support - Access stocks from 5 major markets
Supported Markets
Market Code | Country |
| Japan |
| United States |
| United Kingdom |
| Hong Kong |
| Germany |
Installation
Prerequisites
Rust 1.75+
Cargo
One-liner Install
This will install to ~/.stooq-mcp/. To customize:
Quick Install
The install script will:
Build the project
Register with Claude Code and/or Claude Desktop
Manual Build
The binary will be located at ./target/release/stooq-mcp.
Usage
Claude Code
Register the MCP server with Claude Code:
Claude Desktop
Add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Tools
get_stock_price
Fetches stock price data from stooq.com.
Parameters
Parameter | Type | Required | Description |
| string | ✅ | Stock ticker symbol (e.g., |
| string | ✅ | Market code: |
| string | ❌ | Start date in |
| string | ❌ | End date in |
Examples
Get latest stock price
Toyota Motor (Japan):
Apple (US):
Get historical data
Sony (Japan) - 2024 full year:
Response format
Latest data:
Historical data:
Tech Stack
Rust - Systems programming language
rmcp - MCP server implementation
reqwest - HTTP client
tokio - Async runtime
Limitations
⚠️ Important Notice
stooq.com is an unofficial API and may change without notice
Daily rate limits apply - excessive requests may be blocked
Intended for personal use and learning purposes only
Data accuracy is not guaranteed
License
MIT License - see LICENSE for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.