Shirabe Calendar Api

Name: Shirabe Calendar Api
Author: techwell-inc-jp

@techwell-inc-jp

About Shirabe Calendar Api

Japanese calendar data API for AI agents. Provides Rokuyo, Rekichu (13 types), Kanshi, 24 Sekki, and fortune judgments for 8 categories (wedding, business, moving, etc.). MCP + REST API.

#japanese #calendar #rokuyo #rekichu #fortune #mcp #api

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "shirabe-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@shirabe-api/calendar-mcp"
      ],
      "env": {
        "SHIRABE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Shirabe Calendar API?

Shirabe Calendar API is a REST API and MCP server that provides astronomical-quality Japanese calendar data (rokuyo, rekichu, kanshi, 24 solar terms, lunar date, Japanese era) and purpose-specific auspiciousness judgments with 1–10 scores. It is designed for AI-native applications and integrates seamlessly with ChatGPT, Claude, Gemini, LangChain, and other AI frameworks.

How to use Shirabe Calendar API?

Get started with the free tier (10,000 requests/month) by calling endpoints directly via curl with the X-API-Key header, or without a key for anonymous access. For MCP, add the server to claude_desktop_config.json or use the Streamable HTTP URL. Code examples in TypeScript and Python are provided in the quick start.

Key features of Shirabe Calendar API

Returns 8 purpose-specific auspicious day scores from 1–10
Provides 13 types of rekichu (such as 一粒万倍日 and 天赦日)
Covers the date range 1873-01-01 to 2100-12-31
Exposes three main endpoints: date, range, and best-days
Fully compliant with OpenAPI 3.1 and MCP protocol
Supports AI agent integration via GPTs, Claude, Gemini, and LangChain

Use cases of Shirabe Calendar API

AI chatbot for wedding venues that recommends optimal dates
Moving company AI that scores customer requested dates and suggests alternatives
Fortune telling SaaS that automatically annotates birthdays and