# Stellara MCP

> Stellara MCP is a freemium MCP server for astrology. Swiss Ephemeris natal charts, transits and synastry as exact JSON for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://stellara.natlex.it
- **Repository:** https://github.com/mihnin/stellara-mcp
- **MCP Registry name:** it.natlex/stellara-mcp
- **Categories:** astrology
- **Listing updated:** 2026-11-16

## About

This server gives an assistant a calculator for astrology so it does not guess planetary positions. Four tools run on Swiss Ephemeris in the Stellara cloud: resolving a birth place, calculating a natal chart, computing transits and aspects, and calculating synastry between two people. The server itself does not interpret anything or call an LLM; the assistant reads the returned JSON.

resolve_birth_place turns a place and time into coordinates, an IANA timezone and a datetime with the historically correct UTC offset. The natal chart covers 14 points, 12 house cusps, the angles and every major aspect with exact orb and applying or separating state. Two MCP prompts help gather a birth profile and set a professional astrologer style.

It can be used remotely by URL with a Stellara account sign-in, or locally through the npm package with an API key. The README lists a free tier of 10 requests a day and 5,000 on Stellara Pro.

## Features

- **Birth place resolution:** Maps a city and time to coordinates, timezone and correct historical UTC offset.
- **Natal charts:** 14 points, 12 house cusps, angles and aspects with exact orbs.
- **Transits:** Transiting positions and transit-to-natal aspects at any moment.
- **Synastry:** Inter-chart aspects and house overlays for two people.
- **Guided prompts:** A birth-data intake prompt and an astrologer system prompt.
- **Remote or local:** Connect by URL or run the npm package with an API key.

## Good for

- Have an assistant cast an accurate natal chart
- Check today's transits against a natal chart
- Compare two people's charts
- Ground astrology chats in computed data

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http stellara-mcp https://mcp.stellara.natlex.it/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.stellara.natlex.it/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "stellara-mcp": {
      "url": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "stellara-mcp": {
      "type": "http",
      "url": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "stellara-mcp": {
      "serverUrl": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "stellara-mcp": {
      "type": "http",
      "url": "https://mcp.stellara.natlex.it/mcp"
    }
  }
}
```

## Tools

- `resolve_birth_place`: Resolve a place and time to coordinates, timezone and UTC offset.
- `calculate_natal_chart`: Compute 14 points, house cusps, angles and aspects.
- `get_transits_and_aspects`: Transiting positions and aspects to the natal chart.
- `calculate_synastry`: Inter-chart aspects and house overlays between two people.

## FAQ

### Does the server write the readings?

No. It returns numbers only; the connected assistant does the interpretation.

### What are the usage limits?

The README lists 10 requests per day on the free plan and 5,000 on Stellara Pro.

### How do I connect?

Add the remote URL as a connector and sign in, or install the stellara-mcp npm package with an API key.

### Is Stellara MCP free?

Stellara MCP has a free plan, with paid plans for more usage or features.

### How do I add Stellara MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http stellara-mcp https://mcp.stellara.natlex.it/mcp

### What are the best alternatives to Stellara MCP?

The closest alternatives to Stellara MCP are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

## Alternatives

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/stellara-mcp
