Skip to main content
Glama
Astrologia MCP

Astrologia MCP

by luciano234

Astrologia MCP

Bilingual (English / Spanish) MCP server that gives AI assistants astrology tools powered by the public CosmyDay API: natal charts, today's transits, moon phase, upcoming sky events and daily/weekly/monthly horoscopes.

  • No API key, no account. Only an internet connection is required.

  • 14 read-only tools with typed, validated parameters; descriptions in English and Spanish.

  • stdio and Streamable HTTP transports, Docker image and MCPB bundle.

  • Every response includes the attribution field "fuente": "CosmyDay (https://cosmyday.com)".

Español más abajo: Astrologia MCP (español).

Tools

Tool

What it does

Parameters

natal

Planet positions, Placidus house cusps, aspects and Part of Fortune

year, month, day, hour, minute (local time), lat, lon

search_location

Place name → coordinates (OpenStreetMap Nominatim)

q

transit_today

Today's sky summary, top aspects and interpretation

—

moon_phase

Article about the current moon phase

—

week_ahead

Astrological forecast for the next seven days

—

monthly_overview

Astrological overview of the month

—

events_upcoming

Lunations, eclipses, retrogrades, ingresses, seasons

days, min_importance, kind, limit, from_date (all optional)

event_kinds

Available event types and counts

—

daily_horoscope

Daily horoscope (all signs or one)

sign (optional)

weekly_horoscope

Weekly horoscope

sign (optional)

monthly_horoscope

Monthly horoscope

sign (optional)

monthly_archive_list

Archived sign/month horoscopes

—

monthly_archive

One archived monthly horoscope

sign, yyyy_mm

health_check

API status

—

Signs are written in English and lowercase: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.

Example prompts

  • "Natal chart for 16/12/1968 at 00:09 in Maracaibo" (the assistant calls search_location, then natal).

  • "Show me today's transits."

  • "Which eclipses and retrogrades are coming in the next 90 days?"

  • "Leo's horoscope for this week."

Related MCP server: AstroChalit MCP Server

Installation

Requires Python 3.10+ (or Docker). The easiest way is with uv.

Claude Code

claude mcp add --scope user --transport stdio astrologia -- uvx --from git+https://github.com/luciano234/astrologia-mcp.git astrologia-mcp

Claude Desktop, Cursor, Windsurf and other clients

Add this to your client's MCP configuration (for Claude Desktop: Settings > Developer > Edit Config, claude_desktop_config.json):

{
  "mcpServers": {
    "astrologia": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/luciano234/astrologia-mcp.git",
        "astrologia-mcp"
      ]
    }
  }
}

Install a specific version from GitHub

Every release is a Git tag (see CHANGELOG.md). Add @<tag> to the GitHub URL to pin a version instead of using the latest commit:

uvx --from git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0 astrologia-mcp
claude mcp add --scope user --transport stdio astrologia -- uvx --from git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0 astrologia-mcp

With pip:

pip install git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0

In a JSON client configuration, use "git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0" as the --from argument.

MCPB bundle (one-click install)

Download astrologia-mcp-<version>.mcpb from the Releases page and open it with Claude Desktop. To build it yourself:

npx @anthropic-ai/mcpb pack

Docker

docker build -t astrologia-mcp .
docker run -i --rm astrologia-mcp

Client configuration:

{
  "mcpServers": {
    "astrologia": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "astrologia-mcp"]
    }
  }
}

Streamable HTTP (remote deployments)

MCP_TRANSPORT=http PORT=8000 astrologia-mcp

The endpoint is http://<host>:8000/mcp. With Docker: docker run --rm -e MCP_TRANSPORT=http -p 8000:8000 astrologia-mcp. app.py also exposes an ASGI app (app:app) for platforms that run Uvicorn.

Variable

Default

Description

MCP_TRANSPORT

stdio

stdio or http

HOST

0.0.0.0

Bind address in HTTP mode

PORT

8000

Port in HTTP mode

Local development

git clone https://github.com/luciano234/astrologia-mcp.git
cd astrologia-mcp
python -m pip install -e .
npx @modelcontextprotocol/inspector python server.py

Data and attribution

This project does not provide its own data. It queries the public CosmyDay API at https://api.cosmyday.com (computed with Swiss Ephemeris). CosmyDay requires visible attribution to CosmyDay.com when its data is used commercially; review its terms before publishing an application that displays the data. Tool descriptions and responses include the credit "Source / Fuente: CosmyDay (https://cosmyday.com)".

License

MIT. The license covers this project's code, not CosmyDay's data or services.


Astrologia MCP (español)

Servidor MCP bilingüe (inglés / español) que da a los asistentes de IA herramientas de astrología con datos de la API pública de CosmyDay: cartas natales, tránsitos del día, fase lunar, próximos eventos celestes y horóscopos diarios, semanales y mensuales.

  • Sin clave de API ni cuenta. Solo hace falta conexión a Internet.

  • 14 herramientas de solo lectura con parámetros tipados y validados; descripciones en inglés y español.

  • Transportes stdio y Streamable HTTP, imagen Docker y paquete MCPB.

  • Todas las respuestas incluyen el campo de atribución "fuente": "CosmyDay (https://cosmyday.com)".

Herramientas

Herramienta

Qué hace

Parámetros

natal

Posiciones planetarias, cúspides Placidus, aspectos y Parte de la Fortuna

year, month, day, hour, minute (hora local), lat, lon

search_location

Nombre de lugar → coordenadas (OpenStreetMap Nominatim)

q

transit_today

Resumen del cielo de hoy, aspectos principales e interpretación

—

moon_phase

Artículo sobre la fase lunar actual

—

week_ahead

Pronóstico de los próximos siete días

—

monthly_overview

Panorama astrológico del mes

—

events_upcoming

Lunaciones, eclipses, retrogradaciones, ingresos, estaciones

days, min_importance, kind, limit, from_date (opcionales)

event_kinds

Tipos de evento disponibles y su conteo

—

daily_horoscope

Horóscopo diario (todos los signos o uno)

sign (opcional)

weekly_horoscope

Horóscopo semanal

sign (opcional)

monthly_horoscope

Horóscopo mensual

sign (opcional)

monthly_archive_list

Horóscopos mensuales archivados

—

monthly_archive

Un horóscopo mensual archivado

sign, yyyy_mm

health_check

Estado de la API

—

Los signos se escriben en inglés y minúsculas: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.

Ejemplos de uso

  • "Carta natal del 16/12/1968 a las 00:09 en Maracaibo" (el asistente llama a search_location y luego a natal).

  • "Muéstrame los tránsitos de hoy."

  • "¿Qué eclipses y retrogradaciones vienen en los próximos 90 días?"

  • "Horóscopo semanal de leo."

Instalación

Requiere Python 3.10+ (o Docker). Lo más sencillo es usar uv.

Claude Code

claude mcp add --scope user --transport stdio astrologia -- uvx --from git+https://github.com/luciano234/astrologia-mcp.git astrologia-mcp

Claude Desktop, Cursor, Windsurf y otros clientes

Agrega esto a la configuración MCP de tu cliente (en Claude Desktop: Settings > Developer > Edit Config, claude_desktop_config.json):

{
  "mcpServers": {
    "astrologia": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/luciano234/astrologia-mcp.git",
        "astrologia-mcp"
      ]
    }
  }
}

Instalar una versión concreta desde GitHub

Cada versión es una etiqueta (tag) de Git (ver CHANGELOG.md). Añade @<tag> a la URL de GitHub para fijar una versión en lugar de usar el último commit:

uvx --from git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0 astrologia-mcp
claude mcp add --scope user --transport stdio astrologia -- uvx --from git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0 astrologia-mcp

Con pip:

pip install git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0

En la configuración JSON de un cliente, usa "git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0" como argumento de --from.

Paquete MCPB (instalación con un clic)

Descarga astrologia-mcp-<versión>.mcpb desde Releases y ábrelo con Claude Desktop. Para generarlo tú mismo:

npx @anthropic-ai/mcpb pack

Docker

docker build -t astrologia-mcp .
docker run -i --rm astrologia-mcp

Configuración del cliente:

{
  "mcpServers": {
    "astrologia": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "astrologia-mcp"]
    }
  }
}

Streamable HTTP (despliegue remoto)

MCP_TRANSPORT=http PORT=8000 astrologia-mcp

El endpoint es http://<host>:8000/mcp. Con Docker: docker run --rm -e MCP_TRANSPORT=http -p 8000:8000 astrologia-mcp. app.py expone además una aplicación ASGI (app:app) para plataformas que ejecutan Uvicorn.

Variable

Por defecto

Descripción

MCP_TRANSPORT

stdio

stdio o http

HOST

0.0.0.0

Dirección de escucha en modo HTTP

PORT

8000

Puerto en modo HTTP

Desarrollo local

git clone https://github.com/luciano234/astrologia-mcp.git
cd astrologia-mcp
python -m pip install -e .
npx @modelcontextprotocol/inspector python server.py

Datos y atribución

Este proyecto no ofrece datos propios: consulta la API pública de CosmyDay en https://api.cosmyday.com (calculada con Swiss Ephemeris). CosmyDay requiere atribución visible a CosmyDay.com cuando sus datos se usan comercialmente; revisa sus condiciones antes de publicar una aplicación que muestre esos datos. Las descripciones y las respuestas de las herramientas incluyen el crédito "Source / Fuente: CosmyDay (https://cosmyday.com)".

Licencia

MIT. La licencia cubre el código de este proyecto, no los datos ni los servicios de CosmyDay.

Available Tools

14 tools
daily_horoscopeDaily HoroscopeA

Horóscopo diario. Sin 'sign' devuelve los doce signos; con 'sign' devuelve solo ese signo (en inglés y minúsculas, ej. 'leo').

Inputs: sign. Returns: object

event_kindsEvent KindsB

Lista todos los tipos de evento disponibles junto con su conteo.

Inputs: no named parameters. Returns: object

events_upcomingEvents UpcomingC

Eventos astrológicos (retrogradaciones, lunaciones, eclipses, cambios de signo) en los próximos N días.

Inputs: days, kind, limit, from_date, +1 more. Returns: object

health_checkHealth CheckC

Estado del servicio de la API.

Inputs: no named parameters. Returns: object

monthly_archiveMonthly ArchiveB

Horóscopo mensual archivado para un signo y mes específicos (formato yyyy-mm, ej. '2026-03').

Inputs: sign (required), yyyy_mm (required). Returns: object

monthly_archive_listMonthly Archive ListA

Lista todos los meses-signo archivados disponibles.

Inputs: no named parameters. Returns: object

monthly_horoscopeMonthly HoroscopeB

Horóscopo mensual. Sin 'sign' devuelve los doce signos; con 'sign' devuelve solo ese signo.

Inputs: sign. Returns: object

monthly_overviewMonthly OverviewB

Artículo con la visión general astrológica del mes.

Inputs: no named parameters. Returns: object

moon_phaseMoon PhaseB

Artículo sobre la fase lunar actual.

Inputs: no named parameters. Returns: object

natalNatalB

Posiciones planetarias, cúspides de casas y aspectos para un momento de nacimiento. La hora es local a las coordenadas dadas; la zona horaria se resuelve automáticamente.

Inputs: day (required), lat (required), lon (required), hour (required), +3 more. Returns: object

search_locationSearch LocationA

Convierte un nombre de lugar en las coordenadas que necesita /natal (vía OpenStreetMap Nominatim).

Inputs: q (required). Returns: object

transit_todayTransit TodayB

Artículo sobre los tránsitos astrológicos de hoy.

Inputs: no named parameters. Returns: object

week_aheadWeek AheadB

Pronóstico astrológico de los próximos siete días.

Inputs: no named parameters. Returns: object

weekly_horoscopeWeekly HoroscopeA

Horóscopo semanal. Sin 'sign' devuelve los doce signos; con 'sign' devuelve solo ese signo.

Inputs: sign. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 14 tools

    Disambiguation4/5

    Tool purposes are mostly distinct, but week_ahead vs weekly_horoscope and monthly_overview vs monthly_horoscope could be confused without careful reading. Descriptions clarify scope (general forecast vs per-sign horoscope), so selection is generally reliable.

    Naming Consistency3/5

    All names use snake_case, but construction patterns vary: adjective_noun (daily_horoscope), noun_noun (moon_phase), noun_adverb (week_ahead), and a verb_noun outlier (search_location). This is readable but not a single consistent convention.

    Tool Count5/5

    14 tools is within the ideal 3–15 range, and each tool covers a distinct astrological data type or operation. No excessive redundancy.

    Completeness4/5

    The surface covers daily/weekly/monthly horoscopes, monthly archives, events, moon phase, transits, natal charts, and location lookup. Missing historical daily/weekly archives and specific-date horoscopes are minor gaps but not fatal for current-use workflows.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Provides Vedic astrology tools to AI assistants, enabling birth chart calculation, daily Panchang, and nakshatra profiles via the star-meet.com API.
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP-compatible AI clients to access structured GetBirthChart astrology calculations such as natal charts, planet positions, the big three, moon sign, rising sign, aspects, and synastry through the public API.
      7
      28 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to retrieve precise astrology calculations, including natal charts, transits, composites, harmonic midpoints, and ranked daily aspects, using real ephemeris data rather than guesses.
      5
      1
      AGPL 3.0