# Shirabe Calendar API

Japanese calendar API for AI agents. Provides Rokuyo (六曜), Rekichu (暦注), Eto (干支), 24 Solar Terms, and fortune judgments for dates. Perfect for answering questions like "Is today a lucky day for a we…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add r-yoshikawa/shirabe-calendar

# Browse available tools
npx -y @smithery/cli@latest tool list r-yoshikawa/shirabe-calendar

# Get full schema for a tool
npx -y @smithery/cli@latest tool get r-yoshikawa/shirabe-calendar get_japanese_calendar

# Call a tool
npx -y @smithery/cli@latest tool call r-yoshikawa/shirabe-calendar get_japanese_calendar '{}'
```

## Direct MCP Connection

Endpoint: `https://shirabe-calendar--r-yoshikawa.run.tools`

**Required config:**
- `api_key` (query) — Shirabe API Key (get one at https://shirabe.dev)

## Tools (3)

- `get_japanese_calendar` — 日本の暦情報を取得します。指定した日付の六曜（大安・仏滅等）、
- `find_best_days` — 指定した用途（結婚・開業・引っ越し等）に最適な日を
- `get_calendar_range` — 日付範囲内の暦情報を一括取得します。

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get r-yoshikawa/shirabe-calendar <tool-name>
```