12 Chinese Zodiac Signs
Chinese zodiac animal, element and daily readings by birth date, for any AI client
- Pricing
- Free
- Platforms
- Web, API
- Runs
- Remotely
- Version
- 1.0.3
- Listing updated
- 3 days ago
About 12 Chinese Zodiac Signs
12 Chinese Zodiac Signs is a free MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.
A Chinese zodiac year starts at Chinese New Year, not on 1 January, which is the usual reason a January or February birthday gets the wrong animal. This server checks a date against the real boundary before naming the sign, and returns the boundary it used.
Six tools cover the ground: finding a sign and element from a birthday or birth year, a sign's profile with matches, lucky numbers, colours and flowers and its 2026 and 2027 outlook, details of a zodiac year between 1924 and 2032, pair compatibility with the branch and element relations behind it, the element of a date, and a daily reading worked out from the day's animal plus the next seven days.
It is a hosted Streamable HTTP endpoint with no account or key. The repository documents the connector only, not the website code.
Install
Run in a terminal
claude mcp add --transport http 12-chinese-zodiac-signs https://12chinesezodiacsigns.com/api/mcpAdd to Settings → Connectors → Add custom connector
https://12chinesezodiacsigns.com/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"12-chinese-zodiac-signs": {
"url": "https://12chinesezodiacsigns.com/api/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"12-chinese-zodiac-signs": {
"type": "http",
"url": "https://12chinesezodiacsigns.com/api/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"12-chinese-zodiac-signs": {
"serverUrl": "https://12chinesezodiacsigns.com/api/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"12-chinese-zodiac-signs": {
"type": "http",
"url": "https://12chinesezodiacsigns.com/api/mcp"
}
}
}Tools this server provides (6)
Read directly from the server.
- find_my_sign
- Returns the Chinese zodiac animal, element, polarity and zodiac year for a birthday, with the Chinese New Year boundary that decided it, or for a birth year alone.
- get_sign
- Returns a Chinese zodiac sign's years, personality, best and hardest matches, lucky numbers, colours and flowers, and its 2026 and 2027 outlook.
- get_birth_year
- Returns the animal, element and exact dates of a zodiac year from 1924 to 2032, with its personality, best and hardest matches, lucky things and 2026 and 2027 outlook.
- check_compatibility
- Returns how two Chinese zodiac animals sit together: the match level, why, and the traditional branch and element relations behind it. The same animal may be given twice.
- get_element
- Returns the Chinese zodiac element of a birth date or of a zodiac year, with what it means for that year's animal. Accepts a birth date or a year, not both.
- get_daily_reading
- Returns a sign's reading for a date, worked out from the day's animal and the traditional relations: work, love, energy, the best and hardest signs that day and the next seven days. The date defaults to today in China time (UTC+8).
What it does
- Boundary-aware lookup
- Names the animal and element using the exact Chinese New Year date.
- Sign guides
- Returns years, personality, matches, lucky numbers and 2026-2027 outlook.
- Year details
- Covers zodiac years from 1924 to 2032.
- Pair compatibility
- Explains match level with the traditional branch and element relations.
- Daily readings
- Gives work, love and energy notes plus the next seven days.
Good for
- Find the right animal for a January birthday
- Compare two animals before a match
- Look up lucky colours for a sign
- Read today's guidance for a sign
Pricing
Free
No account or key required
Prices change. Check 12chinesezodiacsigns.com before you buy.
12 Chinese Zodiac Signs FAQ
Is a login required?
No. The endpoint has no authentication.
Which years are covered?
The birth year tool covers 1924 to 2032.
Why can a January birthday give a different animal?
The zodiac year changes at Chinese New Year, which the lookup checks.
Are the tools read-only?
Yes, all tools only return information.
Is 12 Chinese Zodiac Signs free?
Yes. 12 Chinese Zodiac Signs is free to use.
How do I add 12 Chinese Zodiac Signs to Claude Code?
Run this command in your terminal: claude mcp add --transport http 12-chinese-zodiac-signs https://12chinesezodiacsigns.com/api/mcp
What are the best alternatives to 12 Chinese Zodiac Signs?
The closest alternatives to 12 Chinese Zodiac Signs are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.
Alternatives to 12 Chinese Zodiac Signs
Natal Chart Lab
MCP serverKeyless MCP server for planet positions, retrogrades, Moon phases and birth placements
Runs locally- 5 tools
- Open source
- Astrology

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments