Stooq MCP

1# stooq-mcp
2 
3[日本語](README.ja.md)
4 
5A Model Context Protocol (MCP) server written in Rust that fetches stock price data from [stooq.com](https://stooq.com).
6 
7## Demo
8 
9https://github.com/user-attachments/assets/63b55175-80c3-42aa-a28a-bdb21c66169e
10 
11## Features
12 
13- **Latest stock prices** - Get real-time stock price data
14- **Historical data** - Retrieve historical stock data with custom date ranges
15- **Multi-market support** - Access stocks from 5 major markets
16 
17## Supported Markets
18 
19| Market Code | Country |
20|-------------|---------|
21| `jp` | Japan |
22| `us` | United States |
23| `uk` | United Kingdom |
24| `hk` | Hong Kong |
25| `de` | Germany |
26 
27## Installation
28 
29### Prerequisites
30 
31- Rust 1.75+
32- Cargo
33 
34### One-liner Install
35 
36```bash
37curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
38```
39 
40This will install to `~/.stooq-mcp/`. To customize:
41 
42```bash
43STOOQ_MCP_DIR=/your/path curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
44```
45 
46### Quick Install
47 
48```bash
49git clone https://github.com/hoqqun/stooq-mcp.git
50cd stooq-mcp
51./install.sh
52```
53 
54The install script will:
551. Build the project
562. Register with Claude Code and/or Claude Desktop
57 
58### Manual Build
59 
60```bash
61cargo build --release
62```
63 
64The binary will be located at `./target/release/stooq-mcp`.
65 
66## Usage
67 
68### Claude Code
69 
70Register the MCP server with Claude Code:
71 
72```bash
73claude mcp add stooq-mcp /path/to/stooq-mcp/target/release/stooq-mcp
74```
75 
76### Claude Desktop
77 
78Add the following to your Claude Desktop configuration file:
79 
80**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
81**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
82**Linux**: `~/.config/Claude/claude_desktop_config.json`
83 
84```json
85{
86  "mcpServers": {
87    "stooq-mcp": {
88      "command": "/path/to/stooq-mcp/target/release/stooq-mcp"
89    }
90  }
91}
92```
93 
94## Tools
95 
96### `get_stock_price`
97 
98Fetches stock price data from stooq.com.
99 
100#### Parameters
101 
102| Parameter | Type | Required | Description |
103|-----------|------|----------|-------------|
104| `ticker` | string | ✅ | Stock ticker symbol (e.g., `"7203"`, `"AAPL"`) |
105| `market` | string | ✅ | Market code: `jp`, `us`, `uk`, `hk`, `de` |
106| `start_date` | string | ❌ | Start date in `YYYYMMDD` format (e.g., `"20240101"`) |
107| `end_date` | string | ❌ | End date in `YYYYMMDD` format (e.g., `"20241231"`) |
108 
109## Examples
110 
111### Get latest stock price
112 
113**Toyota Motor (Japan):**
114```
115Get the current stock price for Toyota (7203) in Japan market.
116```
117 
118**Apple (US):**
119```
120Get the latest AAPL stock price from US market.
121```
122 
123### Get historical data
124 
125**Sony (Japan) - 2024 full year:**
126```
127Get Sony (6758) stock price history from January 1, 2024 to December 31, 2024.
128```
129 
130### Response format
131 
132**Latest data:**
133```csv
134Symbol,Date,Time,Open,High,Low,Close,Volume
1357203.JP,2024-12-27,16:00:00,2500,2520,2480,2510,1000000
136```
137 
138**Historical data:**
139```csv
140Date,Open,High,Low,Close,Volume
1412024-01-04,2450,2480,2440,2470,800000
1422024-01-05,2470,2490,2460,2485,750000
143...
144```
145 
146## Tech Stack
147 
148- **Rust** - Systems programming language
149- **[rmcp](https://crates.io/crates/rmcp)** - MCP server implementation
150- **[reqwest](https://crates.io/crates/reqwest)** - HTTP client
151- **[tokio](https://crates.io/crates/tokio)** - Async runtime
152 
153## Limitations
154 
155> ⚠️ **Important Notice**
156 
157- stooq.com is an **unofficial API** and may change without notice
158- **Daily rate limits** apply - excessive requests may be blocked
159- Intended for **personal use and learning purposes** only
160- Data accuracy is not guaranteed
161 
162## License
163 
164MIT License - see [LICENSE](LICENSE) for details.
165 
166## Contributing
167 
168Contributions are welcome! Please feel free to submit a Pull Request.
169