# 12 Chinese Zodiac Signs

> 12 Chinese Zodiac Signs is a free MCP server for astrology. Chinese zodiac animal, element and daily readings by birth date, for any AI client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://12chinesezodiacsigns.com
- **Repository:** https://github.com/pyxlino/12chinesezodiacsigns-mcp
- **MCP Registry name:** com.12chinesezodiacsigns/12-chinese-zodiac-signs
- **Categories:** [astrology](https://ai-powered.com/categories/astrology)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http 12-chinese-zodiac-signs https://12chinesezodiacsigns.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://12chinesezodiacsigns.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "12-chinese-zodiac-signs": {
      "url": "https://12chinesezodiacsigns.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "12-chinese-zodiac-signs": {
      "type": "http",
      "url": "https://12chinesezodiacsigns.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "12-chinese-zodiac-signs": {
      "serverUrl": "https://12chinesezodiacsigns.com/api/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://12chinesezodiacsigns.com/api/mcp
```

Enter a Name (for example "12 Chinese Zodiac Signs"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "12-chinese-zodiac-signs": {
      "type": "http",
      "url": "https://12chinesezodiacsigns.com/api/mcp"
    }
  }
}
```

## Tools

- `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).

## 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 Get Chinese Astrology, Unified Reading, Daily Horoscope, Findmyzodiac and Zodiac Compatibility.

## Where this comes from

- Description: written from the project's README and the project's website.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Get Chinese Astrology](https://ai-powered.com/mcp/get-chinese-astrology): Get Chinese Astrology is a free MCP server for astrology.
- [Unified Reading](https://ai-powered.com/mcp/unified-reading): Unified Reading is a freemium MCP server for astrology.
- [Daily Horoscope](https://ai-powered.com/mcp/daily-horoscope): Daily Horoscope is an MCP server for astrology.
- [Findmyzodiac](https://ai-powered.com/mcp/findmyzodiac): Findmyzodiac is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.
- [Liki — Professional AI Astrologer](https://ai-powered.com/mcp/liki-professional-ai-astrologer): Liki — Professional AI Astrologer is a freemium MCP server for astrology.
- [TianJi Astrology](https://ai-powered.com/mcp/tianji-astrology): TianJi Astrology is an open-source MCP server for astrology.
- [zodiak.info.pl](https://ai-powered.com/mcp/zodiak-info-pl): zodiak.info.pl is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/12-chinese-zodiac-signs
