MCP.so
Sign In
S

Shirabe Calendar Api

@techwell-inc-jp

Repository

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

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

3

日本の暦情報を取得します。指定した日付の六曜（大安・仏滅等）、 暦注（一粒万倍日・天赦日・不成就日等）、干支、二十四節気を返します。 さらに、結婚式・引っ越し・建築着工・開業などの用途別に その日が吉か凶かの判定とアドバイスも返します。 使用場面: - 「今日は大安？」「明日の六曜は？」 - 「11月15日に結婚式はどう？」 - 「来週の一粒万倍日はいつ？」 - 「今日は何か縁起が良い日？」 Returns Japanese calendar information including Rokuyo (six-day cycle fortune), Rekichu (auspicious/inauspicious day indicators like Ichiryumanbaibi and Tenshanichi), Kanshi (sexagenary cycle), and Nijushi Sekki (24 solar terms). Also provides context-aware fortune judgments for events like weddings, construction starts, business openings, and more.

指定した用途（結婚・開業・引っ越し等）に最適な日を 期間内から探してランキングで返します。 六曜と暦注を総合的に評価し、最も縁起の良い日から順に返します。 使用場面: - 「来月で結婚式に最適な日はいつ？」 - 「今年中に開業するなら何日がベスト？」 - 「4月の大安の一粒万倍日はある？」 - 「引っ越しに良い日を3つ教えて」 Finds the best auspicious days for a specific purpose (wedding, business opening, moving, etc.) within a date range. Returns ranked results combining Rokuyo and Rekichu evaluations.

日付範囲内の暦情報を一括取得します。 六曜や暦注でフィルタリングできます。 使用場面: - 「来月の大安を全部教えて」 - 「今年の天赦日一覧」 - 「今月の一粒万倍日はいつ？」 Retrieves calendar information for a date range with optional filtering by Rokuyo or Rekichu type.

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

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

techwell-inc-jp

Submitted by

Shirabe-dev-sys

More Developer Tools MCP servers

Repo Test Architect

RepoAssay

Local-first, read-only MCP server for evidence-backed repository test architecture audits and test planning.

ZeroBeacon — 1000-Tool Collision-Proof Commerce Router

DavidFox998

ZeroBeacon.ai — Collision-proof commerce router for AI agents. 1000 MCP tools: commerce, trust, billing, sovereign ID + everyday tools. LIVE.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

12

Termany

thinkany-ai

Agent-Native Terminal

174

extentos

Asger mølgaard

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses: