English Français العربية

Stooq MCP

Community Finance and payments

Fetch real-time stock prices from Stooq for global markets, including the US, Japan, UK and Germany.

Source code Documentation

What can you do with Stooq MCP?

  • 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

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. stooq-mcp
  2. Demo
  3. Features
  4. Supported Markets
  5. Installation
  6. Usage
  7. Tools
  8. Examples
  9. Tech Stack
  10. Limitations
  11. License
  12. Contributing

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 CodeCountry
jpJapan
usUnited States
ukUnited Kingdom
hkHong Kong
deGermany

Installation

Prerequisites
  • Rust 1.75+
  • Cargo
One-liner Install
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
Quick Install
git clone https://github.com/hoqqun/stooq-mcp.git
cd stooq-mcp
./install.sh

The install script will:

  1. Build the project
  2. Register with Claude Code and/or Claude Desktop
Manual Build
cargo build --release

The binary will be located at ./target/release/stooq-mcp.

Usage

Claude Code

Register the MCP server with Claude Code:

claude mcp add stooq-mcp /path/to/stooq-mcp/target/release/stooq-mcp
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

{
  "mcpServers": {
    "stooq-mcp": {
      "command": "/path/to/stooq-mcp/target/release/stooq-mcp"
    }
  }
}

Tools

get_stock_price

Fetches stock price data from stooq.com.

Parameters
ParameterTypeRequiredDescription
tickerstring✅Stock ticker symbol (e.g., "7203", "AAPL")
marketstring✅Market code: jp, us, uk, hk, de
start_datestring❌Start date in YYYYMMDD format (e.g., "20240101")
end_datestring❌End date in YYYYMMDD format (e.g., "20241231")

Examples

Get latest stock price

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.
Get historical data

Sony (Japan) - 2024 full year:

Get Sony (6758) stock price history from January 1, 2024 to December 31, 2024.
Response format

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
...

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.

Frequently asked questions

What is Stooq MCP?

Fetch real-time stock prices from Stooq for global markets, including the US, Japan, UK and Germany.

How do I install Stooq MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Stooq MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Stooq MCP?

It is published by hoqqun. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.