home / mcp / edinet mcp server

Edinet MCP Server

Provides programmatic access to EDINET data with normalized labels and MCP tools for AI assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ajtgjmdjp-edinet-mcp": {
      "command": "uvx",
      "args": [
        "edinet-mcp",
        "serve"
      ],
      "env": {
        "EDINET_API_KEY": "your_key_here"
      }
    }
  }
}

Edinet MCP Server provides a ready-to-use MCP endpoint for Japan’s EDINET XBRL data. You run the local server, supply your EDINET API key, and then you can query normalized financial statements and metrics through your AI tooling, using a consistent Japanese-label interface across accounting standards.

How to use

Set up and run the Edinet MCP Server, then connect your MCP client to the local server to access normalized financial data.

How to install

Prerequisites: You need a working environment with the ability to install Python packages and run MCP configurations via your client. You also need an EDINET API key.

# Install the Edinet MCP package
pip install edinet-mcp

# Alternatively, add to your project’s dependencies if you manage packages via uvx
uv add edinet-mcp

Configuration and usage notes

Configure your client to communicate with the Edinet MCP Server using the standard MCP workflow. A client can start the server as shown in the example configuration and then issue tool calls such as search_companies, get_filings, and get_financial_statements.

{
  "mcpServers": {
    "edinet": {
      "command": "uvx",
      "args": ["edinet-mcp", "serve"],
      "env": {
        "EDINET_API_KEY": "your_key_here"
      }
    }
  },
  "envVars": [
    {
      "name": "EDINET_API_KEY",
      "description": "EDINET API key from the EDINET service",
      "required": true,
      "example": "your_key_here"
    }
  ]
}

How to run the MCP server for Claude Desktop

If you are using Claude Desktop, add the MCP server configuration to your Claude setup. The server runs locally and exposes the Edinet MCP tools to Claude.

{
  "mcpServers": {
    "edinet": {
      "command": "uvx",
      "args": ["edinet-mcp", "serve"],
      "env": {
        "EDINET_API_KEY": "your_key_here"
      }
    }
  }
}

Security considerations

Keep your EDINET API key secure and do not hard-code it into shared configurations. Use environment-based secret management where possible and rotate keys if exposure is suspected.

Examples of typical workflows

- Discover companies by name or EDINET code, then fetch their normalized financial statements for a given period. You can access items like 売上高 (revenue) regardless of whether the underlying standard is J-GAAP, IFRS, or US-GAAP.

- Compute financial metrics such as ROE, ROA, and profit margins, and compare results across periods to observe trends.

Troubleshooting

If the server does not start, ensure the EDINET_API_KEY is valid and exported in your shell. Check that the command and arguments match the MCP configuration and that the environment can access the EDINET API.

If you see missing data or normalization issues, confirm that the taxonomy mappings are loaded and that you are requesting a valid period in the filing year format (for example period="2025").

Available tools

search_companies

Search companies by name, securities code, or EDINET code.

get_filings

Retrieve the list of filings for a given period for a specific EDINET code.

get_financial_statements

Fetch normalized financial statements (BS/PL/CF) for a company and period.

get_financial_metrics

Calculate financial metrics such as ROE, ROA, and profitability measures.

compare_financial_periods

Compare results between periods to show year-over-year changes.

list_available_labels

List all obtainable financial statement labels.

get_company_info

Retrieve detailed information about a company.