Adicione astrologia ao seu agente de IA por meio do MCP

MCP é um protocolo que modelos de IA usam para chamar ferramentas. Pense como uma “REST API para agentes de IA”:

• Servidor expõe ferramentas (cálculos, consultas, ações)
• Cliente (Claude Desktop, Cursor, agente personalizado) as descobre e chama
• O modelo próprio decide quando aplicar cada ferramenta: com base no pedido do utilizador

Servidores MCP podem ser locais (executados como subprocesso) ou remotos (HTTP). A maioria é local, publicada em npm e executada via npx.

Servidor MCP AstroWay expõe uma ferramenta por cada operação da API, 735 no pacote npm e 843 no servidor alojado, com nomes como astroway_<grupo>_<operação>:

• astroway_western_chart e ferramentas adjacentes para cartas, trânsitos, progressões e retornos
• astroway_relational_* para sinastria, composto e cartas de grupo
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: interpretações de IA
• grupos de Human Design, astrologia védica, chinesa, helênica, tarô e numerologia

Para reduzir a lista, ligue um servidor de domínio único em vez do catálogo completo, veja configuração MCP

Registre-se em astroway.info e crie uma chave de API gratuita (10 000 créditos/mês, sem cartão).

O arquivo claude_desktop_config.json:

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

Adicione o servidor astroway:

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

Após reiniciar, as ferramentas AstroWay aparecerão no menu de ferramentas no campo de entrada do chat.

Agora, simplesmente fale com Claude em linguagem natural:

Tu: Constrói o mapa natal de uma pessoa nascida a 14 de julho de 1990 às 14:30 em Kiev. O que significa o seu Sol em Carneiro no 10.º domicílio?

Claude: Chama natal_chart com coordenadas analisadas, depois interpret_placement. Eis o mapa natal. O Sol em Carneiro no 10.º domicílio indica…

Claude próprio:

• analisa linguagem natural (cidade → coordenadas)
• escolhe a ferramenta correta
• formata a resposta

Se estiver a construir um agente de IA personalizado (não Claude Desktop), também pode usar o servidor MCP. O protocolo está documentado:

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');

A maioria dos frameworks de agente (LangChain, LlamaIndex, etc.) tem suporte embutido para MCP.

Se não quiser a sobrecarga do MCP, ligue diretamente para a API HTTP a partir do 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);

Vantagens do MCP: descrições estruturadas de ferramentas, auto-detecção, tratamento padronizado de erros. Vantagens do HTTP: mais simples, funciona em qualquer lugar, sem subprocessos.

Quando o MCP estiver configurado, tente no Claude:

1. “Qual é o meu horóscopo diário? Nasci a 3 de outubro de 1993 às 6 da manhã em Nova Iorque”.
2. “Calcula o meu tipo de Human Design. Nascido a 22 de abril de 1987 às 16:45 em Londres”.
3. “Compara a compatibilidade de duas pessoas: eu (14 de julho de 1990, Kiev) e a minha amiga (22 de março de 1992, Paris)”.
4. “Quais são os principais trânsitos para mim hoje? Dá uma interpretação”.
5. “Não sei a hora exata do nascimento. O que mostra a análise de sensibilidade para um intervalo de ±30 min?”

Claude escolherá as ferramentas necessárias, chamará várias em sequência e formatará a resposta em linguagem humana.

As ferramentas de interpretação de IA da AstroWay (interpret_*, *_horoscope) têm guardas de segurança embutidas:

• Nenhuma aconselhamento médico, legal ou financeiro
• Isenções de responsabilidade injetadas automaticamente
• Filtragem de conteúdo

Quando o agente mostra o texto de interpretação ao utilizador - mantenha a isenção de responsabilidade. Ela está no campo disclaimer de cada resposta de IA.

As chamadas MCP passam pelo mesmo sistema de créditos que o HTTP. Consultas simples (10 créditos) → carta (20) → sinastria (50) → interpretação de IA (50).

Para uso pessoal (um utilizador que faz perguntas ao Claude) - cerca de 200-500 créditos por mês. Com a tarifa gratuita, é mais do que suficiente.

Para um agente de produção com centenas de utilizadores - calcule dependendo da mistura de endpoints. Um bot de horóscopo diário para 1 000 utilizadores = 1 000 × 20 × 30 = 600 000 créditos/mês → plano Pro.

• AstroWay MCP no npm
• Agentes de IA e MCP: caso de uso: guia completo de integração
• API de Horóscopo e Interpretações de IA: página do produto
• Início rápido: obtenha uma chave de API (gratuito, 10 000 créditos/mês)