edinet-mcp

MCP server for Japanese company financials. Gives any MCP client (Claude Desktop, etc.) the main income statement, balance sheet and cash-flow items — normalized to English keys, in JPY — for ~3,600 listed Japanese (non-financial) companies, sourced from Japan's FSA EDINET annual securities reports.

• Free. No API key, no signup, no rate limit.
• Read-only: reads the public JSON at https://edinet-api-base.pages.dev/api/ — no re-fetching from EDINET, no local database.
• Accounting standard auto-detected (IFRS / Japanese GAAP / US GAAP), consolidation and source document included. Items that don't exist under a company's standard are returned as null with a reason (no approximation).

Data attribution: EDINET (Financial Services Agency, Japan). Not investment advice.

Tools

| Tool | What it does | |---|---| | search_company | Find companies by name (EN/JA) or 4-digit code. Resolve a name → code. | | get_financials | Up to 17 income-statement / balance-sheet / cash-flow items + metadata for one company. | | compare_companies | Compare 2+ companies on selected metrics; also returns derived operating_margin_pct / net_margin_pct. | | list_companies | Browse/filter the universe by industry and/or accounting_standard. |

Install & use with Claude Desktop

Option A — via npx (after this package is published to npm)

Add to claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "edinet": { "command": "npx", "args": ["-y", "edinet-mcp"] }
  }
}

Option B — from source (no publish needed)

git clone https://github.com/reanimatedead/edinet-mcp.git && cd edinet-mcp
npm install && npm run build

{
  "mcpServers": {
    "edinet": { "command": "node", "args": ["/absolute/path/to/edinet-mcp/dist/server.js"] }
  }
}

Restart Claude Desktop. Then try:

"Compare Toyota and Nintendo's operating margins."

Claude will call search_company → compare_companies and answer with real figures, e.g. Toyota (7203) operating margin ≈ 7.4%, Nintendo (7974) ≈ 15.6% (FY ending 2026-03, values in JPY).

Tool usage examples

search_company — resolve a name/code to companies:

{ "name": "search_company", "arguments": { "query": "Toyota", "limit": 3 } }
// → { results: [ { sec_code: "7203", name_en: "TOYOTA MOTOR CORPORATION", accounting_standard: "IFRS", ... } ] }

get_financials — 17 items + metadata for one company:

{ "name": "get_financials", "arguments": { "code": "7974" } }
// → { company:{sec_code:"7974", name_en:"Nintendo Co., Ltd."},
//     fiscal_year:{accounting_standard:"Japanese GAAP", ...},
//     flat_values:{ revenue: 2313051000000, operating_income: 360117000000, ... },
//     unavailable:[ { key:"equity_attributable_to_owners", reason:"..." } ] }

compare_companies — side-by-side + derived margins:

{ "name": "compare_companies", "arguments": { "codes": ["7203", "7974"] } }
// → companies: [
//     { code:"7203", values:{revenue:50684952000000, operating_income:3766216000000, ...},
//       derived_ratios:{ operating_margin_pct: 7.43, net_margin_pct: ... } },
//     { code:"7974", ..., derived_ratios:{ operating_margin_pct: 15.57 } } ]

list_companies — browse/filter the universe:

{ "name": "list_companies", "arguments": { "accounting_standard": "US GAAP", "limit": 10 } }
// → { total_matched: 5, results: [ { sec_code:"6301", name_en:"KOMATSU LTD." }, ... ] }

All monetary values are in JPY (absolute yen). derived_ratios are computed from the served values (presentation only — no re-extraction).

Configuration

• EDINET_API_BASE_URL (optional): override the data source base (default https://edinet-api-base.pages.dev/api).

Development

npm run dev        # run from source (tsx)
npm test           # unit tests (mocked fetch, offline)
npm run typecheck
npm run build      # → dist/
node scripts/mcp-smoke.mjs   # end-to-end MCP client smoke against live data

Publishing to npm — HUMAN_ACTION_REQUIRED

npm publish needs an authenticated npm account (browser/OTP) — it cannot be automated here. The package is publish-ready (build output in dist, bin, files, English README). Steps:

cd edinet-mcp
npm login                 # HUMAN: browser/OTP auth
npm run build             # ensure dist/ is fresh
npm publish --access public

After publishing, Option A (npx -y edinet-mcp) works for everyone.

License

MIT. Underlying data © their sources; usage follows the EDINET terms of use.