Stooq

Provides real-time and historical stock data from stooq.com across multiple markets via an MCP server.

rust

1

GitHub Stars

rust

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hoqqun-stooq-mcp": {
      "command": "/path/to/stooq-mcp/target/release/stooq-mcp",
      "args": []
    }
  }
}

You run a Rust-based MCP server that fetches stock price data from stooq.com to provide real-time prices and historical data for multiple markets. You can register the server with Claude and configure it for local use or remote hosting, then query it from your MCP client to retrieve stock information.

How to use

Once you have the stooq MCP server running, you connect to it from your MCP client to request stock prices. You can fetch the latest price for a ticker in a specific market or retrieve historical data for a date range. The server supports five major markets: Japan (jp), United States (us), United Kingdom (uk), Hong Kong (hk), and Germany (de). Use your client to invoke the server’s get_stock_price tool with the chosen ticker and market. The server is designed to work with MCP clients that can call tools exposed by the MCP server and return data in a tabular or CSV-like format for easy consumption.

If you want to integrate the server with Claude Code, you can register the MCP server so your Claude environment can discover and start it when needed. The registration command looks like this in your environment:

Register with Claude Code to make the MCP server available to Claude workflows:

claude mcp add stooq-mcp /path/to/stooq-mcp/target/release/stooq-mcp

How to install

Prerequisites you need before installing: Rust 1.75 or newer and Cargo. Make sure you have a Rust toolchain installed and available on your PATH.

Choose your installation path and run one of the following options to install the MCP server.

One-liner Install

curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash
`

This will install to your home directory by default. To customize the installation path, set the following environment variable before running the install script:

Customize install path

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

Manual Build

cargo build --release

The binary will be located at ./target/release/stooq-mcp. Run it directly from that location when you are ready to start serving requests.


## Available tools

### get\_stock\_price

Fetches stock price data from stooq.com using the MCP server. Supports latest price retrieval and historical data queries by market and ticker.