A Model Context Protocol (MCP) server written in Rust that fetches stock price data from stooq.com. - 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 - Rust 1.75+ This will install to ~/.stooq-mcp/. To customize: The install script will: 1. Build the project 2
Add this skill
npx mdskills install hoqqun/stooq-mcpWell-documented MCP server providing multi-market stock data with clear setup and tool descriptions
A Model Context Protocol (MCP) server written in Rust that fetches stock price data from stooq.com.
https://github.com/user-attachments/assets/63b55175-80c3-42aa-a28a-bdb21c66169e
| Market Code | Country |
|---|---|
jp | Japan |
us | United States |
uk | United Kingdom |
hk | Hong Kong |
de | Germany |
curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
This will install to ~/.stooq-mcp/. To customize:
STOOQ_MCP_DIR=/your/path curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
git clone https://github.com/hoqqun/stooq-mcp.git
cd stooq-mcp
./install.sh
The install script will:
cargo build --release
The binary will be located at ./target/release/stooq-mcp.
Register the MCP server with Claude Code:
claude mcp add stooq-mcp /path/to/stooq-mcp/target/release/stooq-mcp
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
{
"mcpServers": {
"stooq-mcp": {
"command": "/path/to/stooq-mcp/target/release/stooq-mcp"
}
}
}
get_stock_priceFetches stock price data from stooq.com.
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | ✅ | Stock ticker symbol (e.g., "7203", "AAPL") |
market | string | ✅ | Market code: jp, us, uk, hk, de |
start_date | string | ❌ | Start date in YYYYMMDD format (e.g., "20240101") |
end_date | string | ❌ | End date in YYYYMMDD format (e.g., "20241231") |
Toyota Motor (Japan):
Get the current stock price for Toyota (7203) in Japan market.
Apple (US):
Get the latest AAPL stock price from US market.
Sony (Japan) - 2024 full year:
Get Sony (6758) stock price history from January 1, 2024 to December 31, 2024.
Latest data:
Symbol,Date,Time,Open,High,Low,Close,Volume
7203.JP,2024-12-27,16:00:00,2500,2520,2480,2510,1000000
Historical data:
Date,Open,High,Low,Close,Volume
2024-01-04,2450,2480,2440,2470,800000
2024-01-05,2470,2490,2460,2485,750000
...
⚠️ Important Notice
MIT License - see LICENSE for details.
Contributions are welcome! Please feel free to submit a Pull Request.
Install via CLI
npx mdskills install hoqqun/stooq-mcpStooq MCP is a free, open-source AI agent skill. A Model Context Protocol (MCP) server written in Rust that fetches stock price data from stooq.com. - 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 - Rust 1.75+ This will install to ~/.stooq-mcp/. To customize: The install script will: 1. Build the project 2
Install Stooq MCP with a single command:
npx mdskills install hoqqun/stooq-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Stooq MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.