w8s-astro-mcp
Personal astrological MCP server — natal charts, transits, forecasting, and relationship charts backed by a queryable SQLite database.
Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
uvx w8s-astro-mcp==0.15.2Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
claude mcp add io.github.w8s-w8s-astro-mcp -- uvx w8s-astro-mcp==0.15.2Ejecútalo en una terminal.
{ "mcpServers": { "io.github.w8s-w8s-astro-mcp": { "command": "uvx", "args": [ "w8s-astro-mcp==0.15.2" ] } }}claude_desktop_config.json
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Abrir⚠ Upgrading from v0.12 or earlier? Your stored charts were calculated with the wrong time zone. Birth, event and electional times were treated as UT instead of local time, so the Ascendant, MC, houses and Moon were off. Planet signs almost always stay the same. Run
w8s-astro-recalculate --allto see what changes, then add--apply. Details
1. Install uv if you don't have it — see the uv installation guide for your platform.
2. Add to your Claude Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"w8s-astro-mcp": {
"command": "uvx",
"args": ["w8s-astro-mcp"]
}
}
}
3. Restart Claude Desktop, then create your profile:
"Create an astro profile for me — my name is [Name], born [YYYY-MM-DD] at [HH:MM] in [City, State]."
4. Set yourself as the owner:
"Set me as the owner profile."
This tells the server who you are. All tools default to your chart unless you ask about someone else. Everything is stored in ~/.w8s-astro-mcp/astro.db (macOS/Linux) or %USERPROFILE%\.w8s-astro-mcp\astro.db (Windows).
uvx pulls the package from PyPI and runs it in an isolated environment automatically. Use the config above.
pip install w8s-astro-mcp
Then use "command": "w8s-astro-mcp" (no args) in your Claude Desktop config.
If you have an existing database from before v0.12, run the migration script once:
python scripts/migrate_owner_profile.py
This renames the internal current_profile_id column to owner_profile_id. Safe to run multiple times.
Upgrading to v0.14.0 — recalculate your stored charts. Earlier versions used the local birth time as if it were UT, so every stored natal chart has the wrong Ascendant, MC, houses and Moon. Fix it once after upgrading:
w8s-astro-recalculate --all # dry run: shows exactly what would change
w8s-astro-recalculate --all --apply # backs up the database first, then recalculates
# with uvx: uvx --from w8s-astro-mcp w8s-astro-recalculate --all
Add --events to include saved event charts, or --event LABEL to recalculate just one (repeat it for several). It is safe to run more than once, and your AI assistant will mention it after you upgrade if any stored chart still needs recalculating. The compare_charts changes in this release are additive: it keeps its existing output and adds one line per aspect (see the CHANGELOG if you parse that text). If you would rather not be reminded, ask it to dismiss the notice. A note on times: birth time, event time and electional dates are local times (converted using the location's timezone); the time you pass to get_transits, find_house_placements and compare_charts is UT.
If a new install fails with AttributeError: 'Server' object has no attribute 'list_tools': upgrade to v0.12.1 or later (uvx --refresh w8s-astro-mcp, or pip install -U w8s-astro-mcp). Earlier versions did not limit which MCP SDK version they accept, so a new install picked up SDK 2.x, which this server does not support yet.
uvx method) or pipGet started:
"Create an astro profile for me — my name is [Name], born [YYYY-MM-DD] at [HH:MM] in [City, State]."
"Show me my natal chart."
Daily practice:
"What are my transits for today?"
"When was Mercury last retrograde?"
"What major transits are coming up in the next 90 days?"
"Which of today's transits to my chart are building and which are fading?"
Learn what a placement means:
"Make me a placement dials page so I can see what Mars in Taurus in House 3 means." (saves an HTML file to your Downloads folder; open it in a browser)
Other profiles:
"Show me Liz's natal chart."
"What are her transits today?"
"Compare my chart with Liz's." (synastry)
House placements:
"Where are today's planets in my natal houses?"
"Where does today's sky fall in our composite chart?"
Relationships:
"Create a profile for my partner, born [YYYY-MM-DD] at [HH:MM] in [City, State]."
"Create a connection called 'Us' and show me our synastry."
"Calculate a Davison chart for us."
Events & planning:
"Cast a chart for the moment we got married — [date] at [time] in [city]."
"Find auspicious times to sign a contract next month — Moon not void, Mercury direct."
History & research:
"When was Jupiter last in Taurus?"
"Show me all my transit lookups from last month."
See AGENTS.md for the development workflow, testing commands, branch strategy, and release checklist.
Open an issue on GitHub.
Natal charts, transits, history, ingress forecasting, aspects, composite & Davison charts — SQLite.
{ "mcpServers": { "io.github.w8s-w8s-astro-mcp": { "command": "uvx", "args": [ "w8s-astro-mcp==0.15.2" ] } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
W8s Astro se ejecuta localmente por stdio.
Última comprobación: 2026-11-10. Natal charts, transits, history, ingress forecasting, aspects, composite & Davison charts — SQLite.