io.github.yulo-maxPublished by GitHub account yulo-maxv0.6.2Updated Oct 31, 2026
Plain-language astrology: birth chart wheel, sun sign, transits and celebrity star matches (en/nl).
Free, read-only astrology server that gives an assistant sun sign readings, real birth charts, transits and celebrity chart comparisons.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.yulo-max%2Fstellara-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"stellara": {
"type": "http",
"url": "https://mcp.mystellara.com/mcp"
}
}
}Free, read-only MCP server for Stellara. No login, no payment, no database. Variant B: output ends with "Made by Stellara. For self-reflection, not predictions." (Dutch: "Gemaakt door Stellara. ...") and contains no links to mystellara.com. Image and share links use the MCP's own host (mcp.mystellara.com) and carry only computed chart data, never birth data.
Names, descriptions and field descriptions live in src/config.ts; all output texts in src/copy.ts.
This repo is also a Cursor plugin: .cursor-plugin/plugin.json, mcp.json (points to https://mcp.mystellara.com/mcp), skills/stellara-reading/SKILL.md, assets/logo.svg. Check it with npm run validate-plugin.
GET/DELETE /mcp return 405 (no sessions, no SSE stream).
GET /chart.png and GET /chart.svg with ?id=<id> (optional lang=nl) return a full natal chart image (1400x1000): cream background, zodiac ring with coloured sign glyphs and degree ticks, Placidus house segments with numbers and cusp degrees, As/Ds/Mc/Ic, planet glyphs with degrees, aspect lines (green harmonious, red tense), element and quality percentages, and a side table of positions and cusps. PNG is rendered with resvg-js (MPL-2.0, used unmodified) and the bundled DejaVu Sans font (fonts/, free licence), so glyphs look the same everywhere. Same rate limit as /mcp, computed per request, nothing stored. The id is random (128 bits); the computed render data is kept server-side in an in-memory LRU (30 days, max 20,000; optional disk copy when CHART_STORE_DIR is a writable volume). Nothing personal is in the URL or in the image. Unknown or expired ids return 404; memory-only links stop working after a restart. The old ?date= form is refused (400). get_birth_chart returns this URL as chart_image_url and the chart as a PNG image content block (1000 px wide; MCP hosts reject SVG image blocks with "Could not find MIME for Buffer").
get_birth_chart and compare_charts (with celebrity) return share_url (an X post intent with text + share page, never an @tag), share_page_url and share_image_url.
GET /s/match?t=…, GET /s/chart?t=…: share page with og:* and twitter:card=summary_large_image, short text and a button to mystellara.com.GET /match.png?t=…, GET /chart-card.png?t=…: 1200x675 cards.t is base64url JSON with only computed results (sign indexes, whole-degree planet longitudes, score, public celebrity name). No birth date, time or place. Nothing is stored or logged.compare_charts accepts celebrity (name, X handle or a typo of it) instead of person_b and returns a playful match: score (40 to 98), one-liner, plain sentences, a share text for X linking mystellara.com, and a note that it says nothing about anyone's private life. list_celebrities(query?) lists who is available.
data/celebrities.json holds the 1000 most-followed real people on X, built by scripts/build_celebrities.py: ranking from Wikidata follower counts (P8687 with X user-id qualifier, humans only), birth date P569 (day precision), birthplace P19 with coordinates, cross-checked with Grokipedia. Each entry records the source per field and a confidence (high = both agree, medium = one source, low = conflict, flagged in the output). Birth times only where a birth certificate is published (Obama, Trump); everyone else is date-only (no rising sign or houses, said plainly). Wikidata is CC0.
The chart and transit texts are written for people new to astrology: no degrees, no aspect names, no "ascendant", short sentences, main reading at most 6 lines. All technical data (positions, degrees, houses, aspects with orbs, exact transit dates) is in structuredContent.
get_sun_sign_reading(birth_date, language?, voice?): sun sign from a simple date table plus Pythagorean life path number, with short handwritten text, in the third person by default (voice: "second_person" addresses the reader). On the day the sun changes sign (and the day before) it says the sign depends on birth time.create_christmas_star_card(birth_date, recipient_name?, language?): festive card as text plus an SVG image (1080x1350) in Stellara colours.get_birth_chart(birth_date, birth_time?, birth_place? | latitude+longitude+timezone, language?): real positions of Sun to Pluto (tropical, sign, degree, retrograde), major aspects with orbs (conjunction/opposition 8°, trine/square 7°, sextile 5°), and a short character interpretation. Ascendant, Midheaven and Placidus houses (Whole Sign above the polar circles; cusps match astro.com/astrotheme for Einstein) only when both time and place are given. Without a time, 12:00 local is used, Moon aspects are skipped and the Moon is flagged if it changed sign that day. chart_image_url holds only a random id and the language. Ends with the footer.get_transits(birth data, date?, period? = today|week, language?): planet positions at the middle of the UTC window (today or 7 days from date), transits (Sun to Pluto, Moon excluded) to natal planets within 2° (personal) / 1.5° (outer) or exact inside the window, with exact UTC dates when within ±10/45 days.compare_charts(person_a, person_b, language?): synastry; inter-aspects involving at least one personal planet (orbs at 75%), ranked personal-to-personal first, plus counts and a short summary.Birth place: an offline gazetteer of about 171,000 places worldwide (every town with 1000+ inhabitants, from GeoNames cities1000), or latitude, longitude and an IANA timezone. Matching is case- and accent-insensitive (Zurich = Zürich), knows alternate and Dutch names (Den Haag, Den Bosch, Keulen, Luik), and accepts hints: "Hengelo, Gelderland", "Springfield, Illinois", "Ootmarsum, Nederland". Official names are preferred, then population. When a name is ambiguous (for example Springfield) the tool returns an error listing the top 5 candidates with region and country, so the assistant can ask. No external geocoder is called, so places never leave the server.
The gazetteer is preprocessed by scripts/build-gazetteer.mjs into data/gazetteer.tsv.gz (4.5 MB: name, alternate names, country, region, lat, lon, timezone, population). It loads in about 1 second right after start-up (about 210 MB RSS in total).
Place data: GeoNames, licensed CC BY 4.0. See data/NOTICE.md. Chart output names the source in place.source and in the notes. Local time is converted with luxon and the IANA database, so historical daylight saving time is handled (for example no Dutch summer time in 1975).
Positions come from astronomy-engine (MIT, VSOP87 / ELP based): apparent geocentric ecliptic longitude of date. Tests compare all ten bodies against JPL Horizons (quantity 31) for 1990-06-01 12:00 UT and 1879-03-14 10:50 UT: max difference 0.0016°. Ascendant/MC for Einstein (Ulm, 1879-03-14 11:30 LMT) come out at 11°38' Cancer / 12°50' Pisces, same as astro.com.
For the first two tools birth_date (YYYY-MM-DD, also DD-MM-YYYY) is the only required input. language: en (default) or nl. All tools return structuredContent matching their outputSchema (sun_sign, life_path_number, reading/card_text, disclaimer, ...) and the same JSON as a text block. An invalid date returns a tool result with isError: true, not a protocol error. Character and reflection only, no predictions. Only get_birth_chart mentions mystellara.com, once. All text is fixed and handwritten; there are no LLM calls.
Nothing is stored. No database, no files, no request logging, no analytics. Birth dates and names are used only to build the response and are discarded when the request ends. The rate limiter keeps the client IP in memory for at most one minute to count requests; it is never written or logged. The only log line is the startup message.
/mcp (DNS-rebinding protection): requests without an Origin header (normal MCP clients) are allowed; browser requests are allowed only from localhost or origins listed in ALLOWED_ORIGINS (comma separated). Others get 403.30 requests per minute per IP on /mcp (env RATE_LIMIT_PER_MINUTE). Over the limit returns HTTP 429.
Dockerfile (healthcheck /health). The platform sets PORT. No secrets or env vars are required.
MIT. Dependencies are limited to MIT, BSD, Apache-2.0, ISC and MPL-2.0 (resvg-js only, unmodified). No kerykeion, Swiss Ephemeris or other (A)GPL code. The sun sign reading uses a date table; the chart tools use astronomy-engine (MIT) and luxon (MIT). Place data from GeoNames (CC BY 4.0).
POST /render/free-chart returns a portrait PNG (1080 × 1350, brand colours, Cormorant/Inter, OFL fonts in fonts/) and the big three signs, for the free birth chart email. It exists only when FREE_CHART_RENDER_SECRET is set (16+ characters) and the caller sends it in X-Render-Secret; otherwise 404. Birth data only in the POST body, never in a URL, never logged or stored.
Source: README.md at commit e9cd656
Stellara Sun Sign Reading
Returns a short, free reading based only on a birth date: sun sign (simple date table) and Pythagorean life path number, with a few sentences about character, written in the third person by default. No predictions, no personal data stored.
voicelanguagebirth_daterequiredStellara Christmas Star Card
Creates a festive Christmas card (text plus SVG image) about someone, from their birth date and optional first name: sun sign and life path number, described as character, not prediction. The card text talks about the recipient in the third person (by name, or neutrally without a name). No personal data stored.
languagebirth_daterequiredrecipient_nameStellara Birth Chart
Computes a real birth chart from astronomical positions (tropical zodiac): Sun to Pluto with sign, degree and retrograde flag, major aspects with orbs, and a short character-focused interpretation. Ascendant, Midheaven and Whole Sign houses only when birth time and place are both given. Without a time the Moon is flagged as approximate. No predictions, nothing stored.
languagelatitudetimezonelongitudebirth_daterequiredbirth_timebirth_placeStellara Transits
Shows where the planets are now (or on a given UTC date) and which major transits they make to a person's birth chart, with orbs and exact dates, for one day or a 7-day week. Short reflective interpretation, no predictions, nothing stored.
dateperiodlanguagelatitudetimezonelongitudebirth_daterequiredbirth_timebirth_placeStellara Chart Comparison (Synastry)
Compares two birth charts (synastry): the closest aspects between person A's and person B's planets, with orbs and a short, balanced summary. Birth times and places are optional. Instead of person_b you can pass `celebrity` (name or X handle, see list_celebrities) for a playful star match with a score and a share text for X. No predictions, nothing stored.
languageperson_arequiredperson_bcelebrityStellara Famous People
Lists the famous people you can compare charts with in compare_charts (about 1000 most-followed real people on X, birth dates from Wikidata cross-checked with Grokipedia). Optional search query (name, handle or description such as 'singer'); returns up to 25, most followed first. Most are date-only.
query100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npm ci && npm run build && npm start # PORT defaults to 8080npm test # node:test, no extra frameworknpm run license-check # fails on non MIT/BSD/Apache/ISC depsnpx @modelcontextprotocol/inspector --cli http://localhost:8080/mcp --transport http --method tools/list