# Edinet [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/pipeworx-io/mcp-edinet  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1242  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/edinet

## Description
EDINET — Japan's corporate-filings system (Financial Services Agency).

## Tools
Capabilities this server exposes over MCP:

- **edinet_search_filers** — Resolve a Japanese company to its EDINET code and securities code from the FSA's official EDINET filer list — the lookup every other EDINET call needs. Searches Japanese name, English name, kana, EDINET code and ticker across ~11,000 filers, and returns industry, listing status, fiscal year end and corporate number. Needs no API key. Example: edinet_search_filers({ query: "Toyota" }) → E02144 / 7203.
- **edinet_list_filings** — Every disclosure document filed with EDINET on one day — annual and quarterly securities reports, extraordinary reports, large-shareholding reports, tender offers — with filer, document type, period and which formats (XBRL / PDF / CSV / English) exist. Optionally filter to one filer or document type. Requires a free EDINET Subscription-Key via _apiKey. Example: edinet_list_filings({ date: "2026-09-11", limit: 20 }).
- **edinet_company_filings** — All EDINET filings by one Japanese company over a date range of up to 31 days, newest first. EDINET has no company-search endpoint, so this walks the daily filing lists and keeps that filer's rows. Identify the company with edinet_search_filers first. Requires a free EDINET Subscription-Key via _apiKey. Example: edinet_company_filings({ edinet_code: "E02144", from: "2026-06-01", to: "2026-06-30" }).
- **edinet_financials** — Reported annual financials of a Japanese listed company from its EDINET annual securities report: net sales, operating income, net income attributable to owners of the parent, total assets, net assets, with fiscal period, accounting standard (J-GAAP / IFRS / US GAAP), the filing document id, and margins. Each amount states its currency and unit and is the full-fiscal-year figure as filed; an amount whose unit cannot be established is returned unresolved, never guessed. A filer without structured data returns found:false. Requires a free EDINET Subscription-Key via _apiKey. Example: edinet_financials({ sec_code: "8035" }).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "edinet": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-edinet"]
  }
}
```

## Documentation

## What Edinet MCP server does

Edinet MCP server exposes selected EDINET data through MCP for research workflows involving Japanese companies and regulatory filings. EDINET is Japan's securities-filing system and includes securities reports, quarterly and half-year reports, extraordinary reports, large-shareholding reports, tender-offer documents, and associated XBRL, PDF, and CSV materials.

The server's company lookup uses the Financial Services Agency's official EDINET code list, covering roughly 11,400 filers. Searches can use Japanese names, English names, kana, EDINET codes, or exchange tickers. Results provide the EDINET identifier and securities code, which can then be used to find a filer's documents.

## How it works

The MCP endpoint is available at `https://gateway.pipeworx.io/edinet/mcp`. Add that URL as a remote MCP server in a compatible client. The endpoint also exposes shared Pipeworx gateway tools in addition to Edinet's four domain tools, so the result of `tools/list` contains more tools than the Edinet-specific set.

EDINET does not provide a direct company-filings endpoint. Company-specific retrieval therefore starts with the keyless filer search and then examines daily filing lists. The company-filings operation limits a date range to 31 days because it performs this date-oriented lookup pattern.

The EDINET API v2 requires a free Subscription-Key for protected filing-list requests. The caller passes its key as `_apiKey`; the upstream request uses the `Subscription-Key` query parameter. The filer search does not require a key.

## Setup and configuration

Configure the MCP client with the remote endpoint:

```json
{
  "mcpServers": {
    "edinet": {
      "url": "https://gateway.pipeworx.io/edinet/mcp"
    }
  }
}
```

Obtain an EDINET API v2 Subscription-Key separately and provide it as `_apiKey` when calling key-protected tools. No server environment variable is required in the client configuration.

## Tools and capabilities

- `edinet_search_filers` finds filers by name, kana, EDINET code, or ticker and returns EDINET and securities identifiers. It can restrict results to listed companies.
- `edinet_list_filings` lists documents filed on a single date, with optional filer, document-type, and XBRL-only filters.
- `edinet_company_filings` retrieves one filer's filings across a range of up to 31 days, newest first.
- `edinet_financials` extracts annual net sales, operating income, net income attributable to owners, total assets, and net assets from an annual securities report. Results include the fiscal period, accounting basis, filing document ID, margins, currency, and unit information.

Financial values remain in the filing's whole currency units and are not converted or rescaled. Consolidated values take priority; non-consolidated values can appear as labelled fallbacks. The tool reads current-year annual figures rather than cumulative quarterly or half-year amounts.

## Limitations and notes

The filing-list tools cannot operate without a caller-provided Subscription-Key. A company lookup alone is therefore the practical first step for identifying the correct filer, but it does not retrieve filing documents by itself.

EDINET securities codes use five digits, while exchange tickers may use four; Edinet returns both forms. The code list contains individual filers as well as organisations, and personal filers' addresses are omitted. Empty short date ranges can be normal because many Japanese listed companies file annual reports around the same seasonal period.

Structured financial values that lack a currency unit or contain non-numeric text are returned as unresolved, with the original filed text retained. If no annual report or structured data is available, the financials result uses `found: false` rather than an empty result list.

_Full upstream README: https://allmcps.com/mcp/edinet/readme_