Skip to content
MCP server

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/mcp

Add to Settings → Connectors → Add custom connector

https://12chinesezodiacsigns.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "12-chinese-zodiac-signs": {
      "url": "https://12chinesezodiacsigns.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments