Adicione astrologia ao seu agente de IA por meio do MCP

Se trabalhou com o Claude Desktop nos últimos 12 meses — provavelmente viu o MCP (Model Context Protocol). É um padrão aberto da Anthropic para conectar ferramentas externas a modelos de IA. Algumas linhas de configuração e o Claude sabe acessar o sistema de arquivos, bancos de dados ou qualquer API.

Neste post, vamos mostrar como adicionar cálculos astrológicos a um agente de IA por meio do MCP. Tempo necessário: menos de 5 minutos.

MCP é um protocolo pelo qual os modelos de IA chamam ferramentas. Imagine como um “REST API para agentes de IA”:

• Servidor expõe ferramentas (cálculos, consultas, ações)
• Cliente (Claude Desktop, Cursor, agente personalizado) as descobre e as chama
• O modelo decide quando aplicar qual ferramenta — com base na solicitação do usuário

Os servidores MCP podem ser locais (iniciados como subprocesso) e remotos (HTTP). A maioria é local — publicada no npm e iniciada por meio de npx.

O servidor MCP AstroWay expõe 25 ferramentas que cobrem cálculos astrológicos básicos:

• natal_chart — carta natal completa
• synastry — compatibilidade entre duas pessoas
• transits — transitos atuais para a carta natal
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — interpretações de IA
• human_design — carta de design humano completa
• hd_incarnation_cross, hd_compatibility — recursos de design humano
• mais 12 que cobrem progressões, returns solares, astrocartografia, retificação

Registre-se em astroway.info e crie uma chave de API gratuita (10.000 créditos/mês, sem cartã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"
      }
    }
  }
}

Depois de reiniciar, você verá o ícone de martelo com 25 ferramentas disponíveis.

Agora, basta conversar com o Claude em linguagem natural:

Você: Crie uma carta natal para uma pessoa nascida em 14 de julho de 1990, às 14h30, em Kiev. O que significa o Sol em Câncer na 10ª casa?

Claude: Chama natal_chart com coordenadas analisadas, então interpret_placement. Aqui está a carta natal. O Sol em Câncer na 10ª casa indica…

O Claude mesmo:

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

Se você estiver construindo um agente de IA personalizado (não Claude Desktop), o servidor MCP também pode ser usado. O protocolo é 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');

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

// Chamar ferramenta
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 para agentes (LangChain, LlamaIndex, etc.) tem suporte integrado ao MCP.

Se você não quiser os custos adicionais do MCP — chame a API HTTP diretamente 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();
}

// Usando no ciclo do agente
const chart = await callAstrowayTool('chart', birthData);

Vantagens do MCP: descrições estruturadas de ferramentas, autodetecção, tratamento de erros padronizado. Vantagens da API 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 em 3 de outubro de 1993, às 6h da manhã, em Nova York».
2. «Calcule o meu tipo de Design Humano. Nasci em 22 de abril de 1987, às 16h45, em Londres».
3. «Compare a compatibilidade entre duas pessoas: eu (14 de julho de 1990, Kiev) e minha amiga (22 de março de 1992, Paris)».
4. «Quais são os principais transitos para mim hoje? Forneça uma interpretação».
5. «Não sei o horário exato do meu nascimento. O que mostra a análise de sensibilidade para um intervalo de ±30 minutos?»

O Claude mesmo escolherá as ferramentas certas, 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 recursos de segurança integrados:

• Nenhum conselho médico, jurídico ou financeiro
• Disclaimer automático
• Filtro de conteúdo

Quando o agente mostra o texto de interpretação ao usuário — mantenha o disclaimer. Ele está no campo disclaimer de cada resposta de IA.

As chamadas do MCP passam pela mesma sistema de créditos que a API HTTP. Amostras simples (10 créditos) → carta (20) → sinastria (50) → interpretação de IA (50).

Para uso pessoal (um usuário que faz perguntas ao Claude) — cerca de 200-500 créditos por mês. Plano gratuito é suficiente.

Para um agente de produção com centenas de usuários — calcule com base na mistura de endpoints. Bot de horóscopo diário para 1.000 usuários = 1.000 × 20 × 30 = 600.000 créditos/mês → plano Pro.

• AstroWay MCP no npm
• Agentes de IA e MCP — use case — guia de integração completo
• API de Horóscopo e Interpretações de IA — página do produto
• Guia de início rápido — obtenha a chave de API (gratuita, 10.000 créditos/mês)