Sviluppatori: API pubblica e MCP gratuiti

Calcoli e testi aperti

Usa la REST per integrare un sito o il server MCP per dare agli assistenti calcoli verificati di Sole, Luna, ascendente e cielo. Gratis, in sola lettura, senza chiavi o account. Zodiaco tropicale, posizioni geocentriche, case Whole Sign.

Nessun dato di nascita viene conservato o registrato. Body e query non entrano nei log di accesso, nelle statistiche o negli errori. Una chiamata API/MCP invia i dati solo per il calcolo transitorio; il calcolatore del sito lavora nel browser. Il servizio non conserva profili. Le politiche del client scelto restano quelle del suo fornitore.

60 richieste di calcolo o POST MCP al minuto per IP; 120 richieste leggere. Ogni elemento di un batch conta. Il limite viene controllato prima di leggere il body; 429 include Retry-After in secondi. Body massimo 32 KiB, batch massimo 60 messaggi. CORS * senza credenziali.

REST: esempi pronti

Dati di esempio fittizi. Le ricerche di eventi usano [from,to) in UTC, massimo 400 giorni. Gli anni retrogradi vanno dal 1900 al 2099.

OpenAPI 3.1 · Generata dagli schemi Zod, con input, output ed esempi.

curl --fail-with-body -sS 'https://astraluno.com/api/v1/chart' -H 'Content-Type: application/json' --data '{"birth_date":"1990-05-17","birth_time":"14:35","time_precision":"exact","place":{"id":3173435},"lang":"en"}'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/sun-sign?date=1990-05-17&timezone=Europe%2FRome'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/sky?at=2026-10-13T12%3A00%3A00Z&timezone=Europe%2FRome'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/retrogrades?planet=mercury&year=2027'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/ingresses?planet=venus&from=2027-01-01&to=2028-01-01'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/lunations?from=2027-01-01&to=2027-02-01&timezone=Europe%2FRome'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/places?q=Milano&lang=en&limit=8'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/readings/body-in-sign/venus-in-leo?lang=en'

curl --fail-with-body -sS 'https://astraluno.com/api/v1/openapi.json'

Input del tema

birth_date, birth_time?, time_precision exact, approximate oppure unknown. Approximate richiede approx_window_minutes: 15, 30, 60 o 120 (finestra ±). Place è {id} da /places oppure {latitude, longitude, timezone}. Facoltativi utc_offset_override_sec, ambiguity: earlier|later e lang for any published locale.

Risultati e incertezza

Lo snapshot del motore rimane integro, con un riepilogo e link. Tutti i gradi hanno numeri e stringhe D°MM′: degree_strings associa JSON pointer ai numeri originali, compresi intervalli e orbite. Date e orari dichiarano il fuso IANA usato. Gli istanti degli eventi mantengono finestre di incertezza empiriche.

Gli assistenti devono chiedere ora e luogo mancanti, senza ipotizzarli. Ora sconosciuta: niente ascendente o case, due segni lunari quando la Luna cambia segno quel giorno. Sulle cuspidi solari l’ingresso stimato e le alternative restano espliciti. Un’ora senza fuso viene respinta; senza ora e fuso vengono considerate tutte le conversioni del giorno locale.

{
  "error": {
    "code": "AMBIGUOUS_LOCAL_TIME",
    "message": "Choose earlier or later",
    "details": {
      "candidates": []
    }
  }
}

Gli errori riusano i codici del motore: OUT_OF_RANGE, AMBIGUOUS_LOCAL_TIME con candidati, NONEXISTENT_LOCAL_TIME. I candidati reali includono UTC e offset. Non riprovare con un orario inventato.

MCP · Streamable HTTP

https://astraluno.com/mcp · Stateless, JSON, nessun SSE richiesto. Accetta application/json e */*, params: null e batch JSON-RPC. Ogni tool restituisce structuredContent con source, url, result o error, più testo citabile e outputSchema.

• search_birthplace : Trova e disambigua il luogo di nascita
• get_big_three : Sole, Luna e ascendente, con significati e link
• calculate_birth_chart : Posizioni, case, aspetti e incertezza del tema
• get_sun_sign : Segno solare e cuspidi senza ipotesi
• get_planet_positions : Posizioni, retrogradi, fase e illuminazione lunare
• get_retrograde_periods : Stazioni e ombre con finestre temporali
• get_moon_phases : Quattro fasi lunari con orari locali e segni
• get_sign_ingresses : Ingressi e rientri retrogradi nei segni
• get_placement_meaning : Testo gratuito del corpus per segno o casa

curl --fail-with-body -sS 'https://astraluno.com/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"example","version":"1.0"}}}'

Claude Desktop · claude.ai

In Customize → Connectors → + Add → Add custom connector, incolla questi valori. Il connettore remoto è disponibile anche in Claude Desktop tramite lo stesso account. Nessun file locale o bridge richiesto. Guida ufficiale Claude.

Name: Astraluno
Server URL: https://astraluno.com/mcp
Authentication: None

ChatGPT · developer mode

Se richiesto dal tuo workspace, abilita developer mode in Impostazioni → Sicurezza e accesso. In Plugins → + → Add custom MCP server usa i valori sotto, crea il connettore e installalo. In una chat selezionalo con @. Disponibilità e nomi dei menu dipendono dall’account. Guida ufficiale OpenAI · Developer-mode access.

Name: Astraluno
MCP server URL: https://astraluno.com/mcp
Authentication: No authentication

Cursor · .cursor/mcp.json

Salva questa configurazione nel progetto o in ~/.cursor/mcp.json e abilita il server nei tool. Guida ufficiale Cursor.

{
  "mcpServers": {
    "astraluno": {
      "url": "https://astraluno.com/mcp"
    }
  }
}

VS Code · .vscode/mcp.json

Salva il file nel progetto, avvia il server e abilitalo nel selettore tool di Copilot in modalità Agent. Guida ufficiale VS Code.

{
  "servers": {
    "astraluno": {
      "type": "http",
      "url": "https://astraluno.com/mcp"
    }
  }
}

Citazioni e link privati

Cita Astraluno e il page URL restituito nella lingua dell’utente, preservando alternative e incertezza. I significati sono letture simboliche gratuite, non previsioni scientifiche.

open_in_astraluno riapre il calcolatore con gli input nel frammento #d=…&t=…&p=…, che il browser non invia al server. Il form legge e rimuove il frammento dalla barra degli indirizzi. Condividi il link soltanto con la persona interessata: non inserire dati di nascita, frammenti o inputHash in citazioni pubbliche o query.