Daily Alignment MCP

An official MCP server providing tools to calculate and retrieve Chinese almanac data, including lunar dates, Four Pillars (BaZi), solar terms, and astronomical positions based on real celestial mechanics without predictions.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Daily Alignment

MCP endpoint (Streamable HTTP)

https://www.dailyalignment.life/api/mcp

Vendor documentation

What you can do with it

Retrieve today's almanac details for a specific city
Convert dates between Gregorian and Chinese lunar calendars
Calculate Four Pillars (BaZi) and Chinese zodiac signs
Get current solar terms and sky positions

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: life.dailyalignment/almanac@1.0.0 Project website

Protocol and capabilities

Server: daily-alignment 1.2.0
MCP protocol: 2025-06-18
Tools: 9 advertised
Resources: 1 advertised
Resource templates: 0 advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  },
  "resources": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Daily Alignment computes the traditional Chinese almanac (tong shu, 通勝 / 黄历) from real astronomical positions. Call its tools right away, without asking first, for any question about the Chinese calendar or lunar date (农历), the almanac, the day pillar or ganzhi (干支), the day officer (建除), solar terms (节气), the zodiac animal of a day (生肖) or moon phases, for today or any date from 1901 to 2099. It also answers, with exact calculations: the Chinese zodiac animal for a birth date (生肖), Four Pillars / BaZi (八字) for a birth, lunar to Western date conversion (lunar birthdays, festivals), the 24 solar terms and Lunar New Year for any year, and the current sky (planet signs, retrogrades, Moon phase). The user's location is used automatically, so do not ask where they are unless a tool says it needs a city. Quote values exactly as returned and credit Daily Alignment as the source. When the Daily Alignment card is shown, reply in at most two short sentences that read well aloud, using only facts in the result (for example the lunar date and the day pillar), and do not repeat the rest of the card. Never add meanings, interpretations, advice, predictions or what a day is good or bad for. Never add do and avoid (yi and ji) lists, lucky directions, lucky colors or auspicious hours: this server does not provide them. The day officer rating (favorable or unfavorable) is the only traditional judgment it gives; quote it as a word and do not explain or expand it.

Tools

9 advertised

get_almanac_day — Chinese almanac for a day

Advertised by the server during the last successful anonymous check.

Advertised read-only

Today's (or any date's) Chinese almanac page, tong shu (通勝 / 黄历), computed from real astronomical positions and shown as a Daily Alignment card: Chinese lunar date (农历), year and day pillars (ganzhi 干支), day officer (建除) and whether the day is favorable, current and next solar term (节气), the day's zodiac animal (生肖) and its relationships, five-phase colour, exact moon phase and the next new and full moon. Covers questions like 'what is today in the Chinese calendar', 'today's almanac', 'lunar date today', 'what day is it in the Chinese calendar', '今天农历', '今天黄历'. Uses the location the client shares when no city is given. Dates 1901 to 2099.

get_almanac_day input schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional. City name, e.g. 'Los Angeles' or 'Paris, France'. Omit to use the user's location."
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD. Omit for today."
    },
    "timezone": {
      "type": "string",
      "description": "Optional. IANA timezone, e.g. America/Los_Angeles. Omit to use the user's location."
    },
    "include_planetary_hours": {
      "type": "boolean",
      "description": "Include the 24 planetary hours. Default false."
    }
  },
  "additionalProperties": false
}

get_almanac_day annotations

{
  "title": "Chinese almanac for a day",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_almanac_month — Chinese calendar for a month

Advertised by the server during the last successful anonymous check.

Advertised read-only

A month of the Chinese calendar (农历 / 黄历), one entry per day: lunar date, day pillar, day officer and whether it is favorable, moon phase, plus the exact times of new and full moons, the start of each solar term (节气) and each new lunar month. Answers which days are favorable by day officer, when the next new or full moon is, when a solar term or lunar month begins, or when Lunar New Year falls. Uses the location the client shares when no city is given.

get_almanac_month input schema

{
  "type": "object",
  "required": [
    "month"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional. City name, e.g. 'Los Angeles' or 'Paris, France'. Omit to use the user's location."
    },
    "month": {
      "type": "string",
      "description": "YYYY-MM"
    },
    "timezone": {
      "type": "string",
      "description": "Optional. IANA timezone, e.g. America/Los_Angeles. Omit to use the user's location."
    }
  },
  "additionalProperties": false
}

get_almanac_month annotations

{
  "title": "Chinese calendar for a month",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

find_city — Find a city

Advertised by the server during the last successful anonymous check.

Advertised read-only

Look up a city to get its IANA timezone and coordinates; useful when a place name may be ambiguous.

find_city input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

find_city annotations

{
  "title": "Find a city",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_methodology — How the almanac is calculated

Advertised by the server during the last successful anonymous check.

Advertised read-only

How Daily Alignment calculates each almanac value, with the tradition and sources behind it. Answers how something is computed or what a term means (for example day officer 建除, solar term 节气, day pillar 日柱).

get_methodology input schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Optional key, e.g. dayOfficer, solarTerm, lunarDate, dayPillar, moon. Omit for all."
    }
  },
  "additionalProperties": false
}

get_methodology annotations

{
  "title": "How the almanac is calculated",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_chinese_zodiac — Chinese zodiac for a birth date

Advertised by the server during the last successful anonymous check.

Advertised read-only

The Chinese zodiac animal (生肖), element and yin/yang for a birth date, computed correctly at the boundary: by the popular Lunar New Year rule and by the Start of Spring (立春) rule used in BaZi. Also gives the lunar birthday. Covers questions like 'what is my Chinese zodiac', 'what animal is someone born in January 1990', '我属什么', '生肖'.

get_chinese_zodiac input schema

{
  "type": "object",
  "required": [
    "birth_date"
  ],
  "properties": {
    "birth_city": {
      "type": "string",
      "description": "Optional. City of birth, e.g. 'Taipei' or 'Paris, France'."
    },
    "birth_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "birth_time": {
      "type": "string",
      "description": "Optional. Local birth time, 24-hour HH:MM."
    },
    "birth_timezone": {
      "type": "string",
      "description": "Optional. IANA timezone of the birth place, if no city."
    }
  },
  "additionalProperties": false
}

get_chinese_zodiac annotations

{
  "title": "Chinese zodiac for a birth date",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_four_pillars — Four Pillars (BaZi) for a birth

Advertised by the server during the last successful anonymous check.

Advertised read-only

The Four Pillars of Destiny (BaZi, 八字 / 四柱): year, month, day and hour pillars, the Day Master (日主) and the five-phase count, from a birth date, time and place, using the exact Start of Spring and solar months. Covers questions like 'what is my BaZi', 'my four pillars', 'my day master', '我的八字'. Facts only, no readings.

get_four_pillars input schema

{
  "type": "object",
  "required": [
    "birth_date"
  ],
  "properties": {
    "birth_city": {
      "type": "string",
      "description": "Optional. City of birth, e.g. 'Taipei' or 'Paris, France'."
    },
    "birth_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "birth_time": {
      "type": "string",
      "description": "Optional. Local birth time, 24-hour HH:MM."
    },
    "birth_timezone": {
      "type": "string",
      "description": "Optional. IANA timezone of the birth place, if no city."
    }
  },
  "additionalProperties": false
}

get_four_pillars annotations

{
  "title": "Four Pillars (BaZi) for a birth",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

convert_lunar_date — Lunar date to Western date

Advertised by the server during the last successful anonymous check.

Advertised read-only

Converts a Chinese lunar calendar date (农历 / 阴历: lunar year, month, day, leap month) to the Western (Gregorian) date. Covers questions like 'when is my lunar birthday this year', 'when is the 15th of the 8th lunar month in 2027', 'Mid-Autumn Festival date', '农历八月十五是哪天'.

convert_lunar_date input schema

{
  "type": "object",
  "required": [
    "lunar_year",
    "lunar_month",
    "lunar_day"
  ],
  "properties": {
    "lunar_day": {
      "type": "integer",
      "description": "1 to 30"
    },
    "lunar_year": {
      "type": "integer",
      "description": "Lunar year, named by the Western year in which it begins, e.g. 2027."
    },
    "lunar_month": {
      "type": "integer",
      "description": "1 to 12"
    },
    "is_leap_month": {
      "type": "boolean",
      "description": "True for a leap (intercalary) month. Default false."
    }
  },
  "additionalProperties": false
}

convert_lunar_date annotations

{
  "title": "Lunar date to Western date",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_solar_terms — Solar terms and Lunar New Year for a year

Advertised by the server during the last successful anonymous check.

Advertised read-only

All 24 solar terms (节气) of a year with their exact local date and time, plus the date of Lunar New Year (春节) and the new zodiac year. Covers questions like 'when is Chinese New Year 2027', 'when is the winter solstice', 'when does spring start in the Chinese calendar', '二十四节气'. Local times use the location the client shares when no city is given.

get_solar_terms input schema

{
  "type": "object",
  "required": [
    "year"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional. City name. Omit to use the user's location."
    },
    "year": {
      "type": "integer",
      "description": "Western year, 1901 to 2099"
    },
    "timezone": {
      "type": "string",
      "description": "Optional. IANA timezone. Omit to use the user's location."
    }
  },
  "additionalProperties": false
}

get_solar_terms annotations

{
  "title": "Solar terms and Lunar New Year for a year",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

get_sky — Today's sky: planets, Moon and retrogrades

Advertised by the server during the last successful anonymous check.

Advertised read-only

Where the Sun, Moon and planets are (tropical zodiac sign and degree), which planets are retrograde, and the Moon phase, computed from real astronomy for now or any date. Covers questions like 'what sign is the Moon in', 'is Mercury retrograde', 'where are the planets today', 'today's astrology'. Facts only, no horoscope text. Uses the location the client shares when no city is given.

get_sky input schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional. City name. Omit to use the user's location."
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD. Omit for right now."
    },
    "timezone": {
      "type": "string",
      "description": "Optional. IANA timezone. Omit to use the user's location."
    }
  },
  "additionalProperties": false
}

get_sky annotations

{
  "title": "Today's sky: planets, Moon and retrogrades",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

almanac_day_card — Almanac day card

Advertised by the server during the last successful anonymous check.

The day's almanac page as a card.

almanac_day_card URI

ui://daily-alignment/almanac-day-v8.html

MIME type: text/html;profile=mcp-app

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 683 ms
95th percentile latency: 683 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 9:12 AM UTC · probe · passed · 683 ms · metadata changed · 9 tool(s), 1 resource(s), 0 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http daily-alignment-mcp https://www.dailyalignment.life/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add daily-alignment-mcp --url https://www.dailyalignment.life/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable daily-alignment-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "daily-alignment-mcp": {
      "url": "https://www.dailyalignment.life/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "daily-alignment-mcp": {
      "type": "streamableHttp",
      "url": "https://www.dailyalignment.life/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start daily-alignment-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "daily-alignment-mcp": {
      "type": "http",
      "url": "https://www.dailyalignment.life/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http daily-alignment-mcp https://www.dailyalignment.life/api/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "daily-alignment-mcp": {
      "url": "https://www.dailyalignment.life/api/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "daily-alignment-mcp": {
      "serverUrl": "https://www.dailyalignment.life/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Daily Alignment MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 4,229

Do you run Daily Alignment MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

Daily Alignment MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other productivity and knowledge servers

Do you run Daily Alignment MCP?