### Get Company Details Example (Python httpx)

Source: https://edinetdb.jp/docs/api-reference

Example of fetching company details using the httpx library in Python. Requires an API key.

```python
import httpx

response = httpx.get(
    "https://edinetdb.jp/v1/companies/E02144",
    headers={"X-API-Key": "$EDINETDB_API_KEY"},
)

print(response.json())

```

--------------------------------

### Get Company List Example (Python httpx)

Source: https://edinetdb.jp/docs/api-reference

Example of fetching a list of companies using the httpx library in Python. Requires an API key.

```python
import httpx

response = httpx.get(
    "https://edinetdb.jp/v1/companies",
    headers={"X-API-Key": "$EDINETDB_API_KEY"},
    params={"industry": "information-communication", "per_page": 50},
)

print(response.json())

```

--------------------------------

### Setup for Cursor

Source: https://edinetdb.jp/docs/mcp-guide

Instructions for adding EDINET DB as an MCP server in Cursor.

```APIDOC
## Setup for Cursor

Add EDINET DB to your project's `.cursor/mcp.json` or global `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "edinetdb": {
      "url": "https://edinetdb.jp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```
```

--------------------------------

### Setup for Claude Desktop

Source: https://edinetdb.jp/docs/mcp-guide

Instructions for connecting EDINET DB via the `mcp-remote` package for Claude Desktop.

```APIDOC
## Setup for Claude Desktop

Connect via the `mcp-remote` package (requires Node.js 18+):

Configure in `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "edinetdb": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://edinetdb.jp/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}
```
```

--------------------------------

### Direct Connection (curl)

Source: https://edinetdb.jp/docs/mcp-guide

Example requests using curl for initializing MCP connection and calling the `search_companies` tool.

```APIDOC
## Direct Connection (curl)

Standard MCP Streamable HTTP requests:

**1. Initialize Connection**
```bash
curl -X POST https://edinetdb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-03-26",
                 "capabilities":{}, \
                 "clientInfo":{"name":"my-app","version":"1.0"}}}'
```

**2. Search Companies (Requires API Key)**
```bash
curl -X POST https://edinetdb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search_companies",
                 "arguments":{"query":"トヨタ"}}}'
```
```

--------------------------------

### Setup for Claude Code (CLI)

Source: https://edinetdb.jp/docs/mcp-guide

Instructions for adding EDINET DB as an MCP server using the Claude Code CLI.

```APIDOC
## Setup for Claude Code (CLI)

Add EDINET DB as an MCP server from your terminal:

```bash
claude mcp add edinetdb \
  --transport http \
  --url https://edinetdb.jp/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

Alternatively, configure it directly in `.claude/settings.local.json`:

```json
{
  "mcpServers": {
    "edinetdb": {
      "type": "http",
      "url": "https://edinetdb.jp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```
```

--------------------------------

### GET /search

Source: https://edinetdb.jp/docs/api-reference

Searches for companies by name, EDINET code, or stock code. Requires a query parameter 'q'.

```APIDOC
## GET /search

### Description
Searches for companies by name, EDINET code, or stock code.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/search

### Parameters
#### Query Parameters
- **q** (string) - Required - Search query for company name, EDINET code, or stock code.
- **limit** (integer) - Optional - Default: 20 - Maximum value: 100.

### Request Example
```curl
curl "https://edinetdb.jp/v1/search?q=toyota&limit=5"
```

### Response
#### Success Response (200)
- **results** (array) - A list of companies matching the search query.

#### Response Example
```json
{
  "results": [
    {
      "edinet_code": "E01234",
      "company_name": "Toyota Motor Corporation"
    }
  ]
}
```
```

--------------------------------

### GET /companies/{code}/ratios

Source: https://edinetdb.jp/docs/api-reference

Retrieves annual financial ratios for a specific company.

```APIDOC
## GET /companies/{code}/ratios

### Description
Retrieves annual financial ratios (ROE, ROA, operating profit margin, etc.) for a specific company.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/companies/{code}/ratios

### Parameters
#### Path Parameters
- **code** (string) - Required - EDINET code of the company (e.g., E02367).

### Request Example
```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02144/ratios
```

### Response
#### Success Response (200)
- **data** (object) - Annual financial ratios.

#### Response Example
(Example not provided in source)
```

--------------------------------

### Get List of Industries

Source: https://edinetdb.jp/docs/api-reference

Retrieves a list of all industries with their average metrics. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/industries
```

--------------------------------

### Get Financial Ratios

Source: https://edinetdb.jp/docs/api-reference

Retrieve annual financial ratios (ROE, ROA, operating profit margin, etc.) for a company. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02144/ratios
```

--------------------------------

### GET /watchlist

Source: https://edinetdb.jp/docs/api-reference

Retrieves the user's watchlist, which is managed by the email associated with the API key.

```APIDOC
## GET /watchlist

### Description
Retrieves the user's watchlist, which is associated with the email linked to the API key.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/watchlist

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/watchlist
```

### Response
#### Success Response (200)
- **watchlist** (array) - A list of companies in the user's watchlist.

#### Response Example
```json
{
  "watchlist": [
    {
      "edinet_code": "E01234",
      "company_name": "Example Corp",
      "label": "My Favorite"
    }
  ]
}
```

#### Error Responses
- **400** - Email not associated with the API key.
```

--------------------------------

### Get Watchlist

Source: https://edinetdb.jp/docs/api

Retrieve the list of companies currently in your watchlist. Requires an API key for authentication.

```bash
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://edinetdb.jp/v1/watchlist"
```

--------------------------------

### Get Annual Financial Data

Source: https://edinetdb.jp/docs/api-reference

Retrieve financial data for a company over the last 5 years. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/companies/E02144/financials?years=5"
```

--------------------------------

### Get All Companies List

Source: https://edinetdb.jp/docs/api-reference

Retrieve a list of all companies with pagination. Set `per_page` to 5000 to fetch all companies in a single request.

```bash
GET /v1/companies?per_page=5000
```

--------------------------------

### Get Company Details (cURL)

Source: https://edinetdb.jp/docs/api-reference

Fetch detailed information for a specific company using its EDINET code. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02144
```

--------------------------------

### Get Company Details

Source: https://edinetdb.jp/docs/api

Retrieve detailed information about a specific company using its EDINET code. Requires an API key for authentication.

```bash
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://edinetdb.jp/v1/companies/E02367"
```

--------------------------------

### Get Earnings Calendar (cURL)

Source: https://edinetdb.jp/docs/api-reference

Fetch the earnings announcement schedule for a specified date range and market segment. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/calendar?from=2026-05-01&to=2026-05-31&market=prime"
```

--------------------------------

### Get Full Text Blocks from Securities Reports

Source: https://edinetdb.jp/docs/api-reference

Retrieve full text sections from securities reports, including business strategy, content, risks, and management analysis. Set `full=true` to get the entire text. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/companies/E02144/text-blocks?full=true"
```

--------------------------------

### GET /status

Source: https://edinetdb.jp/docs/api-reference

Checks the API status, including health and available endpoints.

```APIDOC
## GET /status

### Description
Retrieves the current status of the API, including its health and a list of available endpoints.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/status

### Response
#### Success Response (200)
- **status** (string) - The current status of the API (e.g., "operational").
- **endpoints** (array) - A list of available API endpoints.

#### Response Example
```json
{
  "status": "operational",
  "endpoints": [
    "/rankings/{metric}",
    "/screener",
    "/search",
    "/status",
    "/watchlist"
  ]
}
```
```

--------------------------------

### GET /industries

Source: https://edinetdb.jp/docs/api-reference

Retrieves a list of all industries with their average key performance indicators.

```APIDOC
## GET /industries

### Description
Retrieves a list of all industries along with their average key performance indicators.

### Method
GET

### Endpoint
/industries

### Responses
#### Success Response (200)
- **全34業種の平均指標** (list) - A list containing average indicators for all 34 industries.

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/industries
```
```

--------------------------------

### GET /shareholders/history

Source: https://edinetdb.jp/docs/api-reference

Retrieves the history of shareholding ratios for filer x issuer.

```APIDOC
## GET /shareholders/history

### Description
Retrieves the history of shareholding ratios for filer x issuer. Useful for analyzing activist investor position trends and holder-side portfolio history.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/shareholders/history

### Parameters
#### Query Parameters
- **filer** (string) - Optional - Filer identifier.
- **issuer** (string) - Optional - Issuer identifier.
- **group** (string) - Optional - Group identifier.
(At least one of `filer`, `issuer`, or `group` is required.)

### Request Example
(Example not provided in source)

### Response Example
(Example not provided in source)
```

--------------------------------

### GET /companies/{code}/segments

Source: https://edinetdb.jp/docs/api-reference

Retrieves segment-specific performance data for a company.

```APIDOC
## GET /companies/{code}/segments

### Description
Retrieves segment-specific sales, operating profit, gross profit, and assets for a company. Supports JP GAAP, IFRS, and US GAAP.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/companies/{code}/segments

### Parameters
#### Path Parameters
- **code** (string) - Required - EDINET code of the company (e.g., E02144).

#### Query Parameters
- **fiscal_year** (integer) - Optional - The fiscal year to retrieve data for.

### Responses
#### Success Response (200)
- **data** (object) - Segment-specific performance data.
#### Error Response (404)
- **message** (string) - Segment data not found.

### Request Example
```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02144/segments
```

### Response Example
(Example not provided in source)
```

--------------------------------

### Configure EDINET DB MCP Server in Claude Code Settings

Source: https://edinetdb.jp/docs/mcp-guide

Add this JSON configuration to your `.claude/settings.local.json` file to set up the EDINET DB MCP server. Ensure you replace YOUR_API_KEY with your actual API key.

```json
{
  "mcpServers": {
    "edinetdb": {
      "type": "http",
      "url": "https://edinetdb.jp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

--------------------------------

### Configure EDINET DB MCP Server for Claude Desktop

Source: https://edinetdb.jp/docs/mcp-guide

Use this JSON configuration with the `mcp-remote` package for Claude Desktop. This requires Node.js 18+ and should be placed in the specified configuration file path. Replace YOUR_API_KEY with your actual API key.

```json
{
  "mcpServers": {
    "edinetdb": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://edinetdb.jp/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}
```

--------------------------------

### GET /shareholders/activists

Source: https://edinetdb.jp/docs/api-reference

Retrieves a list of currently active positions categorized by activist investors.

```APIDOC
## GET /shareholders/activists

### Description
Retrieves a list of currently active positions categorized by activist investors and other holders.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/shareholders/activists

### Parameters
#### Query Parameters
- **category** (string) - Optional - Category of holding purpose (default: `"activist"`).
- **limit** (integer) - Optional - Maximum number of results to return (<= 500, default: 50).

### Responses
#### Success Response (200)
- **data** (array) - List of activist positions.

### Request Example
```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/shareholders/activists?limit=50"
```

### Response Example
(Example not provided in source)
```

--------------------------------

### Available Tools

Source: https://edinetdb.jp/docs/mcp-guide

EDINET DB provides a suite of tools to access company financial data, analysis, and documentation.

```APIDOC
## Available Tools

| Tool Name         | Description                                                                 |
|-------------------|-----------------------------------------------------------------------------|
| `get_company`     | Get basic company information, latest financials, and financial health score. |
| `get_financials`  | Retrieve up to 6 years of financial time-series data.                       |
| `get_analysis`    | AI analysis (financial health score, industry benchmark comparison).        |
| `search_companies`| Search by company name, stock code, industry, financial health score, business tags. |
| `search_companies_batch` | Batch search for multiple companies (useful for comparative analysis).      |
| `get_ranking`     | Get financial indicator rankings (ROE, dividend yield, etc.).               |
| `get_documentation`| Documentation on scoring methods and indicator definitions.                 |
| `get_text_blocks` | Full text of annual reports (business overview, risks, MD&A, etc.).         |
| `get_earnings`    | TDnet earnings release data (preliminary earnings, year-on-year).           |
| `get_earnings_calendar` | JPX earnings announcement schedule.                                         |
| `screen_companies`| Screen companies based on multiple conditions using 123 indicators.           |
| `get_watchlist`   | Retrieve watchlist.                                                         |
| `add_to_watchlist`| Add company to watchlist.                                                   |
| `remove_from_watchlist`| Remove company from watchlist.                                              |
| `get_detailed_expenses`| Breakdown of SG&A expenses (14 categories x 4 groups).                      |
```

--------------------------------

### GET /companies/{code}/shareholders

Source: https://edinetdb.jp/docs/api-reference

Retrieves large shareholding reports for a specified company.

```APIDOC
## GET /companies/{code}/shareholders

### Description
Retrieves large shareholding reports for a specified company, returning the latest filing for each filer group. Data is available for filings from March 2021 onwards due to EDINET API v2 constraints.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/companies/{code}/shareholders

### Parameters
#### Path Parameters
- **code** (string) - Required - EDINET code of the company (e.g., E02144).

### Responses
#### Success Response (200)
- **data** (array) - List of large shareholding reports.
#### Error Response (404)
- **message** (string) - Large shareholding data not found.

### Request Example
```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02144/shareholders
```

### Response Example
(Example not provided in source)
```

--------------------------------

### Configure EDINET DB MCP Server for Cursor

Source: https://edinetdb.jp/docs/mcp-guide

Add this JSON configuration to your `.cursor/mcp.json` (project-specific) or `~/.cursor/mcp.json` (global) file to connect Cursor to EDINET DB. Replace YOUR_API_KEY with your actual API key.

```json
{
  "mcpServers": {
    "edinetdb": {
      "url": "https://edinetdb.jp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

--------------------------------

### Get Company Facilities by Code

Source: https://edinetdb.jp/docs/api-reference

Retrieves a list of major facilities for a company, structured by property unit. Includes FudosanDB data like median land prices and book values. Requires an API key.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02144/facilities
```

--------------------------------

### GET /companies/{code}/financials

Source: https://edinetdb.jp/docs/api-reference

Retrieves annual financial data for a specific company.

```APIDOC
## GET /companies/{code}/financials

### Description
Retrieves annual financial data for a specific company.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/companies/{code}/financials

### Parameters
#### Path Parameters
- **code** (string) - Required - EDINET code of the company.

#### Query Parameters
- **years** (integer) - Optional - Number of past years to retrieve data for.

### Request Example
```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/companies/E02144/financials?years=5"
```

### Response
#### Success Response (200)
- **data** (object) - Annual financial data.

#### Response Example
(Example not provided in source)
```

--------------------------------

### GET /v1/industries

Source: https://edinetdb.jp/docs/api

Retrieves a list of all 33 industries along with their average financial metrics.

```APIDOC
## GET /v1/industries

### Description
Retrieves a list of all 33 industries along with their average financial metrics.

### Method
GET

### Endpoint
`/v1/industries`

### Response
#### Success Response (200)
- **industry_name** (string) - The name of the industry.
- **average_metrics** (object) - An object containing average financial metrics for the industry.

#### Response Example
{
  "example": "[{\"industry_name\": \"Technology\", \"average_metrics\": { \"roe\": 12.3, \"revenue_growth\": 8.5 }}]"
}
```

--------------------------------

### Add EDINET DB MCP Server via Claude Code CLI

Source: https://edinetdb.jp/docs/mcp-guide

Use this command to add the EDINET DB MCP server configuration directly from your terminal. Replace YOUR_API_KEY with your actual API key.

```bash
claude mcp add edinetdb \
  --transport http \
  --url https://edinetdb.jp/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

--------------------------------

### Search Companies (No Authentication)

Source: https://edinetdb.jp/docs/api

Use this endpoint to search for companies by name without requiring an API key. The query parameter 'q' specifies the search term.

```bash
curl "https://edinetdb.jp/v1/search?q=任天堂"
```

--------------------------------

### Search Companies by Name or Code (cURL)

Source: https://edinetdb.jp/docs/api-reference

Search for companies using their name, EDINET code, or stock code. The 'q' parameter is required.

```bash
curl "https://edinetdb.jp/v1/search?q=toyota&limit=5"
```

--------------------------------

### GET /shareholders/history

Source: https://edinetdb.jp/docs/api-reference

Retrieves a list of shareholder history based on filer, group, or issuer EDINET codes.

```APIDOC
## GET /shareholders/history

### Description
Retrieves a list of shareholder history. You can filter by filer, group, or issuer EDINET codes.

### Method
GET

### Endpoint
/shareholders/history

### Query Parameters
- **filer** (string) - Optional - Filer EDINET code (e.g., E27325).
- **group** (string) - Optional - Parent group ID (e.g., strategic_capital).
- **issuer** (string) - Optional - Issuer EDINET code (e.g., E02344).

### Responses
#### Success Response (200)
- **保有履歴リスト** (list) - A list of shareholder history records.

#### Error Response (400)
- **filer/issuer/group のいずれも指定なし** - Indicates that none of the required filter parameters were provided.

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/shareholders/history?filer=E27325"
```
```

--------------------------------

### API Key Management and Limits

Source: https://edinetdb.jp/docs/mcp-guide

Information on obtaining API keys and understanding rate limits.

```APIDOC
## API Key Management and Limits

### Obtaining API Keys

There are two methods to obtain API keys:

| Method                  | Target Clients                                       | Limit        |
|-------------------------|------------------------------------------------------|--------------|
| MCP Connection (OAuth)  | Claude.ai, ChatGPT, etc.                             | 1 per client |
| Manual Issuance (Dashboard) | REST API, Claude Code, Cursor, etc.                  | Up to 3      |

### MCP Connection (Claude.ai / ChatGPT)

* API keys are automatically issued upon authentication with a Google account.
* Old keys are automatically replaced upon reconnection; no manual management is needed.
* Multiple AI clients (e.g., Claude and ChatGPT) can connect simultaneously and are managed independently.
* The dashboard displays only the latest keys for each client, labeled like "MCP (Claude)" or "MCP (ChatGPT)".

### Manual Issuance via Dashboard

* For clients requiring manual configuration like REST API or Claude Code.
* Up to 3 keys can be active per account.
* Disable unused keys to issue new ones.
* Keys are shown only once upon issuance. If lost, disable and re-issue.

### Rate Limits

| Plan      | Daily Limit   | Price     |
|-----------|---------------|-----------|
| Free      | 100 requests/day | Free      |
| Pro       | 1,000 requests/day| ¥4,980/month|
| Business  | 10,000 requests/day| ¥29,800/month|
| Enterprise| Custom        | Quote     |

All plans provide access to all endpoints and fields. Plan differences only affect request limits.
```

--------------------------------

### GET /companies/{code}/text-blocks

Source: https://edinetdb.jp/docs/api-reference

Retrieves text sections from a company's annual securities report.

```APIDOC
## GET /companies/{code}/text-blocks

### Description
Retrieves text sections (business policy, business content, risks, management analysis) from a company's annual securities report. By default, returns a summarized version (max 2,000 characters per section). Set `full=true` to retrieve the full text.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/companies/{code}/text-blocks

### Parameters
#### Path Parameters
- **code** (string) - Required - EDINET code of the company (e.g., E02367).

#### Query Parameters
- **fiscal_year** (integer) - Optional - Specifies the fiscal year (defaults to the latest).
- **full** (boolean) - Optional - Set to `true` to retrieve the full text (defaults to `false`, returning a 2,000-character summary).

### Responses
#### Success Response (200)
- **data** (Array of objects) - Text blocks from the report.
  - **section** (string) - The section name.
  - **text** (string) - The content of the section.
- **meta** (object) - Metadata about the response.
  - **edinet_code** (string) - The EDINET code.
  - **fiscal_year** (integer) - The fiscal year.
  - **full_text_url** (string) - URL to the full text if available.
  - **note** (string) - Additional notes.
  - **sections_count** (integer) - The number of sections.

### Request Example
```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/companies/E02144/text-blocks?full=true"
```

### Response Example
```json
{
  "data": [
    {
      "section": "string",
      "text": "string"
    }
  ],
  "meta": {
    "edinet_code": "string",
    "fiscal_year": 0,
    "full_text_url": "http://example.com",
    "note": "string",
    "sections_count": 0
  }
}
```
```

--------------------------------

### Initialize MCP Connection with curl

Source: https://edinetdb.jp/docs/mcp-guide

This curl command initializes a connection to the EDINET DB MCP endpoint. It sets the necessary headers for JSON-RPC 2.0 communication.

```bash
# 1. Initialize
curl -X POST https://edinetdb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-03-26",
                 "capabilities":{}, \
                 "clientInfo":{"name":"my-app","version":"1.0"}}}'
```

--------------------------------

### Search Companies using curl with API Key

Source: https://edinetdb.jp/docs/mcp-guide

This curl command demonstrates how to search for companies using the `search_companies` method via the MCP Streamable HTTP endpoint. Authentication with an API key is required.

```bash
# 2. Search companies (要APIキー)
curl -X POST https://edinetdb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search_companies",
                 "arguments":{"query":"トヨタ"}}}'
```

--------------------------------

### Get Financial Time Series (Last 3 Years)

Source: https://edinetdb.jp/docs/api

Fetch financial data for a company over the last three years. Specify the number of years using the 'years' query parameter. Requires an API key.

```bash
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://edinetdb.jp/v1/companies/E02367/financials?years=3"
```

--------------------------------

### Get Watchlist (cURL)

Source: https://edinetdb.jp/docs/api-reference

Retrieve the list of companies currently in your watchlist. Requires an API key with an associated email.

```bash
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/watchlist
```

--------------------------------

### GET /shareholders/search

Source: https://edinetdb.jp/docs/api-reference

Performs a reverse search for major shareholders by name to identify companies where they hold significant stakes.

```APIDOC
## GET /shareholders/search

### Description
Searches for major shareholders by name and returns the companies in which they hold large stakes. This is a reverse lookup.

### Method
GET

### Endpoint
/shareholders/search

### Query Parameters
- **limit** (integer) - Optional - Maximum number of results to return. Defaults to 20, maximum is 100.
- **q** (string) - Required - Partial match search for the major shareholder's name.

### Responses
#### Success Response (200)
- **大株主検索結果** (list) - A list of search results for major shareholders.

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/shareholders/search?q=Oasis&limit=20"
```
```

--------------------------------

### MCP Tool for Retrieving Facilities

Source: https://edinetdb.jp/docs/data-quality

Introduces a new MCP tool to fetch facility data, likely for internal or programmatic access.

```python
get_facilities
```

--------------------------------

### Get Financial Time Series Data

Source: https://edinetdb.jp/docs/api-reference

Retrieves historical financial time series data for a specific company.

```APIDOC
## GET /v1/companies/{code}/financials

### Description
Retrieves historical financial time series data for a specific company.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/companies/{code}/financials

### Path Parameters
- **code** (string) - Required. EDINET code (e.g., E02367). Can be obtained from `/search` or `/companies`.

### Query Parameters
- **years** (integer) - Number of years to retrieve (omitted for all periods).

### Responses
#### Success Response (200)
- **Financial time series data**
#### Error Response (404)
- **Financial data not found**

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/companies/E02367/financials?years=5
```
```

--------------------------------

### Get Earnings Calendar

Source: https://edinetdb.jp/docs/api-reference

Retrieves the earnings announcement schedule for companies listed on JPX. Data is updated daily.

```APIDOC
## GET /v1/calendar

### Description
Retrieves the earnings announcement schedule for companies listed on JPX. Data is updated daily.

### Method
GET

### Endpoint
https://edinetdb.jp/v1/calendar

### Query Parameters
- **code** (string) - Securities code.
- **from** (string) - Start date (YYYY-MM-DD).
- **limit** (integer) - Maximum number of results to return (<= 2000). Defaults to 500.
- **market** (string) - Market segment (Enum: "prime", "standard", "growth").
- **to** (string) - End date (YYYY-MM-DD).

### Responses
#### Success Response (200)
- **Earnings announcement schedule**

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  "https://edinetdb.jp/v1/calendar?from=2026-05-01&to=2026-05-31&market=prime"
```
```

--------------------------------

### Get API Status (cURL)

Source: https://edinetdb.jp/docs/api-reference

Check the current health and availability of the EDINETDB API endpoints. No authorization is required for this endpoint.

```bash
curl https://edinetdb.jp/v1/status
```

--------------------------------

### GET /industries/{slug}

Source: https://edinetdb.jp/docs/api-reference

Retrieves a list of companies within a specific industry, along with average performance metrics for that industry.

```APIDOC
## GET /industries/{slug}

### Description
Retrieves a list of companies belonging to a specific industry, along with average performance metrics for that industry.

### Method
GET

### Endpoint
/industries/{slug}

### Path Parameters
- **slug** (string) - Required - The slug identifier for the industry (e.g., `information-communication`).

### Responses
#### Success Response (200)
- **業種内の企業一覧と平均値** (object) - An object containing a list of companies within the industry and average performance values.

### Request Example
```curl
curl -H "X-API-Key: $EDINETDB_API_KEY" \
  https://edinetdb.jp/v1/industries/information-communication
```
```