Aggiungi astrologia al tuo agente AI tramite MCP

Se hai lavorato con Claude Desktop nell’ultimo anno, probabilmente hai visto MCP (Model Context Protocol). È uno standard aperto di Anthropic per connettere strumenti esterni ai modelli AI. Qualche riga di configurazione e Claude sa come accedere al file system, al database o a qualsiasi API.

In questo post - come aggiungere calcoli astrologici a un agente AI tramite MCP. Ci vogliono meno di 5 minuti.

MCP è un protocollo che i modelli AI usano per chiamare strumenti. Immagina come un “REST API per agenti AI”:

• Server espone strumenti (calcoli, richieste, azioni)
• Client (Claude Desktop, Cursor, agente personalizzato) li rileva e li chiama
• Il modello stesso decide quando usare quale strumento: in base alla richiesta dell’utente

I server MCP possono essere locali (avviati come sottoprocessi) o remoti (HTTP). La maggior parte dei server locali viene pubblicata su npm e avviata tramite npx.

Server MCP AstroWay espone uno strumento per ogni operazione API, 735 nel pacchetto npm e 843 sul server ospitato, con nomi come astroway_<gruppo>_<operazione>:

• astroway_western_chart e strumenti vicini per carte, transiti, progressioni e ritorni
• astroway_relational_* per sinastria, composite e carte di gruppo
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: interpretazioni AI
• gruppi di Human Design, astrologia vedica, cinese, ellenistica, tarocchi e numerologia

Per abbreviare l’elenco, connetti un server di dominio singolo invece dell’intero catalogo, vedi configurazione MCP

Registrati su astroway.info e crea una chiave API gratuita (10.000 crediti/mese, senza carta di credito).

Il file claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Aggiungi il server astroway:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Dopo il riavvio, gli strumenti AstroWay appariranno nel menu degli strumenti nel campo di input della chat.

Ora basta parlare con Claude in linguaggio naturale:

Tu: Costruisci una carta natale per una persona nata il 14 luglio 1990 alle 14:30 a Kiev. Cosa significa il suo Sole in Cancro nel 10° casa?

Claude: Chiama natal_chart con coordinate analizzate, poi interpret_placement. Ecco la carta natale. Il Sole in Cancro nel 10° casa indica…

Claude stesso:

• analizza il linguaggio naturale (città → coordinate)
• sceglie lo strumento corretto
• formatta la risposta

Se stai costruendo un agente AI personalizzato (non Claude Desktop), puoi anche usare il server MCP. Il protocollo è documentato:

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// MCP initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// List the tools
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Call a tool
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

La maggior parte dei framework per agenti (LangChain, LlamaIndex, ecc.) ha supporto integrato per MCP.

Se non vuoi la sovraccarico di MCP, chiama l’API HTTP direttamente dall’agente:

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

Vantaggi di MCP: descrizioni strutturate degli strumenti, auto-rilevamento, gestione standardizzata degli errori. Vantaggi di HTTP: più semplice, funziona ovunque, senza sottoprocessi.

Quando MCP è configurato, prova in Claude:

1. “Qual è il mio oroscopo giornaliero? Sono nato il 3 ottobre 1993 alle 6 del mattino a New York”.
2. “Calcola il mio tipo di Human Design. Nato il 22 aprile 1987 alle 16:45 a Londra”.
3. “Confronta la compatibilità tra due persone: io (14 luglio 1990, Kiev) e un’amica (22 marzo 1992, Parigi)”.
4. “Quali sono i transiti principali per me oggi? Dai un’interpretazione”.
5. “Non conosco l’ora esatta di nascita. Cosa mostra l’analisi di sensibilità per un intervallo di ±30 minuti?”

Claude stesso sceglierà gli strumenti necessari, chiamerà in modo coordinato diversi in catena e formatterà la risposta in linguaggio umano.

Gli strumenti di interpretazione AI di AstroWay (interpret_*, *_horoscope) hanno safety-guardrails incorporati:

• Nessun consiglio medico, legale o finanziario
• Disclaimer auto-iniettati
• Filtraggio dei contenuti

Quando l’agente mostra il testo di interpretazione all’utente - mantieni il disclaimer. Si trova nel campo disclaimer di ogni risposta AI.

Le chiamate MCP passano attraverso lo stesso sistema di crediti dell’HTTP. Le semplici estrazioni (10 crediti) → carta (20) → sinastria (50) → interpretazione AI (50).

Per uso personale (un utente che pone domande a Claude) - circa 200-500 crediti al mese. Il piano gratuito è più che sufficiente.

Per un agente di produzione con centinaia di utenti - calcola in base alla miscela di endpoint. Un bot oroscopico giornaliero per 1.000 utenti = 1.000 × 20 × 30 = 600.000 crediti/mese → piano Pro.

• AstroWay MCP su npm
• Agenti AI e MCP: use case: guida completa all’integrazione
• API Horoscope & AI Interpretations: pagina del prodotto
• Avvio rapido: ottieni una chiave API (gratuita, 10.000 crediti/mese)