Astrologia MCP
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., "@Astrologia MCP what's my natal chart for July 4, 1990 at 3:30 PM in Madrid?"
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.
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 |
| Planet positions, Placidus house cusps, aspects and Part of Fortune |
|
| Place name → coordinates (OpenStreetMap Nominatim) |
|
| Today's sky summary, top aspects and interpretation | — |
| Article about the current moon phase | — |
| Astrological forecast for the next seven days | — |
| Astrological overview of the month | — |
| Lunations, eclipses, retrogrades, ingresses, seasons |
|
| Available event types and counts | — |
| Daily horoscope (all signs or one) |
|
| Weekly horoscope |
|
| Monthly horoscope |
|
| Archived sign/month horoscopes | — |
| One archived monthly horoscope |
|
| 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, thennatal)."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-mcpClaude 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-mcpclaude mcp add --scope user --transport stdio astrologia -- uvx --from git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0 astrologia-mcpWith pip:
pip install git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0In 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 packDocker
docker build -t astrologia-mcp .
docker run -i --rm astrologia-mcpClient configuration:
{
"mcpServers": {
"astrologia": {
"command": "docker",
"args": ["run", "-i", "--rm", "astrologia-mcp"]
}
}
}Streamable HTTP (remote deployments)
MCP_TRANSPORT=http PORT=8000 astrologia-mcpThe 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 |
|
|
|
|
| Bind address in HTTP mode |
|
| 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.pyData 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 |
| Posiciones planetarias, cúspides Placidus, aspectos y Parte de la Fortuna |
|
| Nombre de lugar → coordenadas (OpenStreetMap Nominatim) |
|
| Resumen del cielo de hoy, aspectos principales e interpretación | — |
| Artículo sobre la fase lunar actual | — |
| Pronóstico de los próximos siete días | — |
| Panorama astrológico del mes | — |
| Lunaciones, eclipses, retrogradaciones, ingresos, estaciones |
|
| Tipos de evento disponibles y su conteo | — |
| Horóscopo diario (todos los signos o uno) |
|
| Horóscopo semanal |
|
| Horóscopo mensual |
|
| Horóscopos mensuales archivados | — |
| Un horóscopo mensual archivado |
|
| 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_locationy luego anatal)."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-mcpClaude 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-mcpclaude mcp add --scope user --transport stdio astrologia -- uvx --from git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0 astrologia-mcpCon pip:
pip install git+https://github.com/luciano234/astrologia-mcp.git@v1.1.0En 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 packDocker
docker build -t astrologia-mcp .
docker run -i --rm astrologia-mcpConfiguración del cliente:
{
"mcpServers": {
"astrologia": {
"command": "docker",
"args": ["run", "-i", "--rm", "astrologia-mcp"]
}
}
}Streamable HTTP (despliegue remoto)
MCP_TRANSPORT=http PORT=8000 astrologia-mcpEl 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 |
|
|
|
|
| Dirección de escucha en modo HTTP |
|
| 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.pyDatos 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 toolsdaily_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
Scored across 14 tools
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.
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.
14 tools is within the ideal 3–15 range, and each tool covers a distinct astrological data type or operation. No excessive redundancy.
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
Related MCP Connectors
Аccess to personalized Enigmata astrological forecasts (day/week/month/thematic) for AI assistants
Ephemeris-grade natal charts, current transits, zodiac sign profiles. No API key.
Real astrology for AI agents: cosmic weather, synastry, timing, astrocartography, and divination.
Astrology app for ChatGPT and Claude: real charts from NASA JPL DE440, not AI guesses.
Related MCP Servers
- AlicenseAqualityFmaintenanceProvides Vedic astrology tools to AI assistants, enabling birth chart calculation, daily Panchang, and nakshatra profiles via the star-meet.com API.3MIT
- AlicenseCqualityBmaintenanceEnables AI assistants to access real-time Vedic astrology data and perform calculations like horoscopes, panchang, matchmaking, and planetary positions via the AstroChalit API.83ISC
- AlicenseAqualityBmaintenanceEnables 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.728 npmMIT
- AlicenseAqualityCmaintenanceEnables 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.51AGPL 3.0