1. Conduid
  2. Developer Tools
  3. hoqqun/stooq-mcp
MCP server · Developer Tools

hoqqun/stooq-mcp

by · github.com/hoqqun/stooq-mcp

🦀 Rust MCP server for stock prices from stooq.com | 株価取得MCPサーバー

Unclaimed last commit 10 months ago devtools
InstallView source
45Fair

Scored 6 months ago · breakdown

About hoqqun/stooq-mcp

hoqqun/stooq-mcp is an MCP server published by hoqqun in the Developer Tools category: 🦀 Rust MCP server for stock prices from stooq.com | 株価取得MCPサーバー.

The repository has 9 stars and 4 forks, with the last commit 10 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/hoqqun/stooq-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about hoqqun/stooq-mcp

Powered by Claude · Grounded in docs

I know everything about hoqqun/stooq-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

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
jp Japan
us United States
uk United Kingdom
hk Hong Kong
de Germany

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

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")

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.

README fetched from the repository 7 days ago. The original is authoritative.

Questions

About hoqqun/stooq-mcp

How do I install hoqqun/stooq-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is hoqqun/stooq-mcp safe to use with an AI agent?

Its trust score is 45 out of 100 (fair). It passes 3 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is hoqqun/stooq-mcp still maintained?

The last commit was 10 months ago and 1 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.