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

Basic information

Category

Developer Tools

Transports

stdio

Publisher

techwell-inc-jp

Submitted by

Shirabe-dev-sys

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

Comments

More Developer Tools MCP servers

Burp Suite MCP Server Extension

PortSwigger

MCP Server for Burp

961

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

Minecraft MCP Server

yuniko-software

A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction

642

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K