About 12 Chinese Zodiac Signs
12 Chinese Zodiac Signs is a hosted MCP server for exploring Chinese zodiac signs and traditional readings. It supports people looking up a sign from a birth date or year, checking compatibility, and getting daily readings.
Key features
- 01Find an animal and element from a birth date or year
- 02Look up sign traits, years, matches and outlooks
- 03Check compatibility between two signs
- 04Get a dated daily reading and seven-day view
- 05Read-only tools with no authentication
Use cases
- 01Identify a zodiac animal and element for a birthday
- 02Check the traditional match between two animals
- 03Explore a sign’s traits and yearly outlook
- 04Get a sign’s reading for a particular date
MCP support
The hosted connector uses Streamable HTTP at the listed endpoint and requires no authentication. It exposes six read-only tools for zodiac identification, sign and year details, compatibility, elements and daily readings.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://12chinesezodiacsigns.com/api/mcpclaude mcp add --transport http com-12chinesezodiacsigns-12-chinese-zodiac-signs https://12chinesezodiacsigns.com/api/mcp{"mcpServers":{"com-12chinesezodiacsigns-12-chinese-zodiac-signs":{"type":"http","url":"https://12chinesezodiacsigns.com/api/mcp"}}}Open in Cursor{"servers":{"com-12chinesezodiacsigns-12-chinese-zodiac-signs":{"type":"http","url":"https://12chinesezodiacsigns.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-12chinesezodiacsigns-12-chinese-zodiac-signs":{"type":"http","url":"https://12chinesezodiacsigns.com/api/mcp"}}}{"mcpServers":{"com-12chinesezodiacsigns-12-chinese-zodiac-signs":{"serverUrl":"https://12chinesezodiacsigns.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README12 Chinese Zodiac Signs MCP app
Find your Chinese zodiac animal and element, read any sign and check how two signs match.
Give a birth date and get your animal, your element and the Chinese New Year boundary that decided them. Ask about a sign, a birth year, a pair of animals or today's reading. Answers come from the same calendar and traditional readings as 12chinesezodiacsigns.com.
- Website: https://12chinesezodiacsigns.com
- Documentation: https://12chinesezodiacsigns.com/app
- Privacy: https://12chinesezodiacsigns.com/privacy
- Terms: https://12chinesezodiacsigns.com/terms
This repository documents the hosted connector. It does not contain the website or its code.
Connect
- Endpoint:
https://12chinesezodiacsigns.com/api/mcp - Transport: Streamable HTTP
- Authentication: none (no account, sign-in or API key)
{ "mcpServers": { "12-chinese-zodiac-signs": { "url": "https://12chinesezodiacsigns.com/api/mcp" } } }
In ChatGPT, add it as a custom MCP server with no authentication. In Claude, open Customize, then Connectors, choose Add custom connector and enter the URL.
Tools
All tools are read-only.
| Tool | What it does |
|---|---|
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. |
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. |
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. |
Try asking
- "What Chinese zodiac animal and element am I if I was born on 15 March 1990?"
- "Are the Rat and the Dragon a good match?"
- "What does the Chinese daily horoscope say for the Tiger today?"
Report an issue
Open an issue in this repository or email [email protected].
License
The documentation files in this repository are MIT licensed (see LICENSE). The 12 Chinese Zodiac Signs website, its content, data and brand are not covered by this license.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.