Edinet

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:

{
  "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.