Skip to content
MCP server

irkumo

Look up IR page and earnings-release list URLs for 3,821 Japanese listed companies

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.2
Listing updated
1 day ago

About irkumo

irkumo is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Anyone building a crawler or research assistant for Japanese equities has to find each company's investor-relations page first. irkumo does that lookup and returns the IR page URL and the earnings-release (kessan tanshin) list URL, matching on securities code, current name, former names or brand names.

Usage is metered in credits: each returned column in a row costs one credit, and a search costs one credit regardless of result count, free when it finds nothing. The site prices a credit at 2 yen, gives 50 trial credits valid 30 days on a free sign-up with no card, and adds 30 free credits each month for customers who have bought a pack. The server asks for only the columns you need and appends credits charged and remaining to every reply. Insufficient balance returns a purchase link rather than an error.

The data is assembled from public sources including the EDINET code list, gBizINFO, local government codes and Wikidata aliases. Calls are limited to 20 requests per 10 seconds per key. The site and docs are in Japanese.

Install

Run in a terminal

claude mcp add irkumo-mcp --env IRKUMO_API_KEY='<IRKUMO_API_KEY>' -- npx -y irkumo-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "irkumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "irkumo-mcp"
      ],
      "env": {
        "IRKUMO_API_KEY": "<IRKUMO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "irkumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "irkumo-mcp"
      ],
      "env": {
        "IRKUMO_API_KEY": "<IRKUMO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "irkumo-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "irkumo-mcp"
      ],
      "env": {
        "IRKUMO_API_KEY": "<IRKUMO_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "irkumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "irkumo-mcp"
      ],
      "env": {
        "IRKUMO_API_KEY": "<IRKUMO_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "irkumo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "irkumo-mcp"
      ],
      "env": {
        "IRKUMO_API_KEY": "<IRKUMO_API_KEY>"
      }
    }
  }
}

Configuration

  • IRKUMO_API_KEYirkumo API key (ir_live_...). Free sign-up: https://api.irkumo.com/account/loginRequired

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

resolve_company
Resolves a name or alias to one company code.
search_companies
Lists candidate companies with chosen attributes.
get_company
Returns requested columns for a securities code.
list_changes
Returns rows changed since a point in time.
get_balance
Shows credit balance and expiry.
list_fields
Lists columns, unit prices and sources.

What it does

Company resolution
resolve_company turns a name, alias or brand into one securities code.
Candidate search
search_companies lists matches with attributes such as industry and prefecture.
Column-level data
get_company returns only the requested columns, for example the IR page URL.
Change feed
list_changes returns rows that changed since a given date or version.
Credit visibility
get_balance and list_fields show balance, expiry, prices and sources.
Alias matching
Handles spelling variants, former company names and brands.

Good for

  • Find a company's IR page from its ticker for a document crawler
  • Resolve a messy company nickname to a securities code
  • Monitor which IR links changed since last month
  • Filter listed companies by industry, prefecture or fiscal month

Pricing

Freemium

Pay per credit at 2 yen; 50 free trial credits and 30 monthly free credits.

Prices change. Check irkumo.com before you buy.

irkumo FAQ

What does it cost?

A credit is 2 yen; each returned column is one credit and a search is one credit.

Is there a free trial?

Yes, 50 credits valid for 30 days with no card, plus 30 free credits monthly after a purchase.

Do I need an API key?

Yes. Sign up with an email address and create an IRKUMO_API_KEY.

What are the rate limits?

The README states 20 requests per 10 seconds per key.

Is irkumo free?

irkumo has a free plan, with paid plans for more usage or features.

How do I add irkumo to Claude Code?

Run this command in your terminal: claude mcp add irkumo-mcp --env IRKUMO_API_KEY='<IRKUMO_API_KEY>' -- npx -y irkumo-mcp

What are the best alternatives to irkumo?

The closest alternatives to irkumo are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to irkumo

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments