Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nocturna-mcp Can you calculate my natal chart for June 15, 1990, 2:30 PM in Los Angeles?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) server for Nocturna astrology APIs.
Gives AI agents a full astrologer skill: natal charts, transits, synastry, progressions, returns, and chart image rendering — 20 tools total.
Tool | Description |
| Natal (birth) chart: planets, houses, aspects |
| Cross-aspects between two charts |
| Composite/Davison chart for a couple |
| Current transits to a natal chart |
| Secondary progressions or solar arc |
| Solar or lunar return chart |
| Primary directions / solar arc directions |
| Solar/lunar eclipses in a date range |
| Planetary sign ingresses in a date range |
| Fixed stars conjunct natal planets |
| Arabic parts / lots |
| Essential dignities (rulership, exaltation, etc.) |
| Antiscia and contra-antiscia |
| Declinations and parallels |
| Harmonic charts |
| Lunar nodes, Lilith, Selena |
| Birth time rectification from life events |
Tool | Description |
| Calculate + render natal chart as PNG |
| Biwheel: natal (inner) + transits (outer) |
| Biwheel: person 1 (inner) + person 2 (outer) |
Related MCP server: auseklis
Bun runtime
Access to Nocturna API (service token required)
git clone https://github.com/eaprelsky/nocturna-mcp
cd nocturna-mcp
bun installCopy .env.example to .env and fill in your API tokens:
cp .env.example .envAdd to your .mcp.json:
{
"mcpServers": {
"nocturna": {
"command": "bun",
"args": ["run", "/path/to/nocturna-mcp/server.ts"],
"env": {
"NOCTURNA_API_URL": "https://www.calc.nocturna.ru/api",
"NOCTURNA_SERVICE_TOKEN": "your_token",
"CHART_SERVICE_URL": "https://www.img.nocturna.ru",
"NOCTURNA_IMAGE_SERVICE_TOKEN": "your_image_token"
}
}
}
}Calculate Lady Gaga's natal chart:
→ calculate_natal_chart(date="1986-03-28", time="09:53:00", latitude=40.7128, longitude=-74.0060, timezone="America/New_York")
Render the chart as an image:
→ render_natal_chart(date="1986-03-28", time="09:53:00", latitude=40.7128, longitude=-74.0060, timezone="America/New_York", person_name="Lady Gaga")
Check transits for today:
→ calculate_transits(natal_date="1986-03-28", natal_time="09:53:00", natal_latitude=40.7128, natal_longitude=-74.0060, transit_date="2026-03-28")MIT
This server cannot be deployed
MCP server for the Seline Analytics API
Hosted MCP server for live public-data APIs and Skills for AI agents.
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Free MCP server: 36 security & dev API tools -- WHOIS, DNS, CVE, IP reputation, Cosmos SDK.