The whole surface is a sign and a time range, and the response arrives already split into sections — so an assistant can answer 'what about my career this month' without a second call. Readings are returned in Chinese, which is worth knowing before you wire it into an English-facing product.
A single-purpose server that fetches horoscope readings from a horoscope API and returns them formatted. One tool covers all twelve signs and four time ranges, and the response includes the sub-readings rather than one paragraph.
- `get-horoscope` takes a `type` — one of `aries`, `taurus`, `gemini`, `cancer`, `leo`, `virgo`, `libra`, `scorpio`, `sagittarius`, `capricorn`, `aquarius`, `pisces`
- And a `time` — `today`, `nextday`, `week` or `month`
- The reading breaks into overall fortune, love, career, wealth and health
- Lucky numbers, lucky colours and compatible signs come back with it
- Plus the things to do and to avoid for the period
- Invalid signs and time ranges are validated and rejected with a message rather than passed through
Node.js and npm. Published as horoscope version 1.0.0. The Smithery one-liner is `npx -y @smithery/cli install @GBcui/horoscope-serve --client claude`; by hand, clone the repo, `npm install`, `npm run build`, then register node against `build/index.js`. No API key and no account.
One command — npx -y @smithery/cli install @GBcui/horoscope-serve --client claude