Summary
A Swiss Ephemeris backed astrology server that stores natal charts, transit lookups, and relationship charts in a local SQLite database. It exposes tools for creating multi-profile charts, querying historical planetary positions, generating composite and Davison relationship charts, and scanning date ranges for electional astrology. Every transit lookup gets auto-logged so you can query your astrological history by date, planet, or sign. Reach for this if you want programmatic access to precise ephemeris calculations with persistent storage, or if you're building conversational astrology workflows that need to remember past readings and manage charts for multiple people. Runs via uvx with no separate install.
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
An agent that runs the SEO playbooks that move rankings and ships PRs you control.
Get founding access →
Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.
Try For Free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →w8s-astro-mcp
Personal astrological MCP server — natal charts, transits, forecasting, and relationship charts backed by a queryable SQLite database.
Features
- 🔭 Swiss Ephemeris precision — planetary positions via pysweph; optional high-precision file download
- 🗂️ Multi-profile — manage charts for yourself, family, and friends
- 📜 Persistent history — every transit lookup auto-logged to SQLite; query by date, planet, or sign
- 🔗 Relationship charts — composite and Davison charts for any group of 2+ people; place today's sky in any chart's house system
- 🗓️ Event & electional tools — cast charts for any moment; scan windows for auspicious times
Quick Start
1. Install uv if you don't have it — see the uv installation guide for your platform.
2. Add to your Claude Desktop config:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%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).
Installation
Recommended: uvx (no install required)
uvx pulls the package from PyPI and runs it in an isolated environment automatically. Use the config above.
Alternative: pip
pip install w8s-astro-mcp
Then use "command": "w8s-astro-mcp" (no args) in your Claude Desktop config.
Upgrading from an earlier version
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.
Requirements
- Python 3.10+
- uv (for
uvxmethod) or pip - Claude Desktop (or any MCP-compatible client)
Use Cases
Get 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?"
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."
Documentation
| Doc | Contents |
|---|---|
| docs/ARCHITECTURE.md | Directory structure, full tool list, data flow, design decisions |
| docs/DATABASE_SCHEMA.md | Full ERD, all models, example SQL queries |
| docs/ROADMAP.md | Phase history and planned work |
| docs/TESTING_MCP.md | How to configure Claude Desktop and smoke-test the server |
Contributing & Development
See AGENTS.md for the development workflow, testing commands, branch strategy, and release checklist.
Questions & Bugs
Open an issue on GitHub.
License
Featured
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →An agent that runs the SEO playbooks that move rankings and ships PRs you control.
Get founding access →Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.
Try For Free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
