Skip to main content
Glama
eaprelsky

nocturna-mcp

by eaprelsky
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

nocturna-mcp

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.

Tools

Calculations (via nocturna-calculations API)

Tool

Description

calculate_natal_chart

Natal (birth) chart: planets, houses, aspects

calculate_synastry

Cross-aspects between two charts

calculate_composite

Composite/Davison chart for a couple

calculate_transits

Current transits to a natal chart

calculate_progressions

Secondary progressions or solar arc

calculate_returns

Solar or lunar return chart

calculate_directions

Primary directions / solar arc directions

calculate_eclipses

Solar/lunar eclipses in a date range

calculate_ingresses

Planetary sign ingresses in a date range

calculate_fixed_stars

Fixed stars conjunct natal planets

calculate_arabic_parts

Arabic parts / lots

calculate_dignities

Essential dignities (rulership, exaltation, etc.)

calculate_antiscia

Antiscia and contra-antiscia

calculate_declinations

Declinations and parallels

calculate_harmonics

Harmonic charts

calculate_special_points

Lunar nodes, Lilith, Selena

calculate_rectification

Birth time rectification from life events

Chart Rendering (via nocturna-image API)

Tool

Description

render_natal_chart

Calculate + render natal chart as PNG

render_transit_chart

Biwheel: natal (inner) + transits (outer)

render_synastry_chart

Biwheel: person 1 (inner) + person 2 (outer)

Related MCP server: auseklis

Setup

Prerequisites

  • Bun runtime

  • Access to Nocturna API (service token required)

Install

git clone https://github.com/eaprelsky/nocturna-mcp
cd nocturna-mcp
bun install

Configure

Copy .env.example to .env and fill in your API tokens:

cp .env.example .env

Add to Claude Code

Add 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"
      }
    }
  }
}

Example Usage

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")

License

MIT

This server cannot be installed

F
license - not found
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Precision astronomical

    scottchronicity
    A
    license
    -
    quality
    C
    maintenance
    A self-contained MCP server that gives AI agents the ability to calculate high-precision astronomical data. It provides tropical zodiac coordinates, planetary speeds, retrograde detection, and house cusps using the trusted Swiss Ephemeris engine. 100%
    Last updated
    2
    AGPL 3.0

  • auseklis

    igmizo
    A
    license
    A
    quality
    A
    maintenance
    Astrology MCP server that computes natal charts, transits, synastry, progressions, returns, eclipses, retrogrades, and moon phases from a real ephemeris, enabling AI agents to provide accurate astrological calculations without hallucination.
    Last updated
    12
    66
    1
    MIT

  • AstroConsultant

    brmh
    F
    license
    -
    quality
    D
    maintenance
    An AI astrology MCP server providing 49 tools for Western and Vedic astrology calculations, including natal charts, dashas, transits, and compatibility analysis, powered by Swiss Ephemeris.
    Last updated

  • astrology-mcp

    akuttruff
    F
    license
    -
    quality
    D
    maintenance
    MCP server for astrological calculations including natal charts, planetary positions, aspects, transits, and progressions using Swiss Ephemeris.
    Last updated

View all related MCP servers

Related MCP Connectors

  • Horoscope

    Horoscope MCP — wraps the keyless Horoscope App API.

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • mcp

    MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/eaprelsky/nocturna-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server