# irkumo

> irkumo is a freemium MCP server for finance and payments. Look up IR page and earnings-release list URLs for 3,821 Japanese listed companies. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://irkumo.com
- **Repository:** https://github.com/ozumin-dev/irkumo-mcp
- **MCP Registry name:** com.irkumo/irkumo-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/irkumo
