FreeAstroAPI Astrology

MCP Hospedado

Conecte o FreeAstroAPI diretamente a ferramentas de IA por meio de um servidor MCP hospedado. Você não precisa instalar um servidor local, executar um script ou compilar nada antes. Adicione uma URL, adicione sua chave de API, reconecte sua ferramenta de IA e ela poderá começar a chamar endpoints de astrologia como ferramentas.

Melhor para usuários que priorizam IA: se o seu aplicativo oferecer “MCP Remoto”, “MCP Hospedado” ou “MCP HTTP Streamable”, escolha essa opção. Se ele apenas pedir um comando de terminal, esse aplicativo espera um servidor stdio local.

URL do Servidor MCP

HTTP https://api.freeastroapi.com/mcp

Claude Desktop: extensão com um clique

O formulário de Conector Personalizado do Claude Desktop não pode adicionar o cabeçalho x-api-key. Instale esta extensão de desktop. Ela solicita sua chave FreeAstroAPI durante a configuração e não requer comandos de terminal.

Baixar para Claude Desktop (.dxt)

/downloads/mcp/freeastroapi-claude-desktop.dxt

Instalação em quatro etapas

1. Baixe o arquivo da extensão.
2. Abra Claude Desktop → Configurações → Extensões → Configurações avançadas.
3. Escolha Instalar Extensão e selecione o arquivo baixado.
4. Cole sua chave de API e ative o FreeAstroAPI em Busca e ferramentas.

1. Adicione o servidor

No seu aplicativo de IA, crie um novo servidor MCP remoto e cole a URL desta página.

2. Adicione sua chave de API

Envie sua chave como o cabeçalho x-api-key. O servidor MCP usa a mesma chave e os mesmos limites da API normal.

3. Comece a perguntar

Após a conexão, sua IA pode descobrir ferramentas e chamá-las diretamente, em vez de adivinhar dados de astrologia.

Configuração Rápida

Name: FreeAstroAPI
Type: Remote / Hosted MCP server
URL: https://api.freeastroapi.com/mcp

Header:
x-api-key: YOUR_API_KEY

O Que Sua IA Obtém

Ferramentas de consulta e utilitárias

• Busca de Cidades
• Fase Lunar
• Linha do Tempo da Fase Lunar
• Efemérides
• Endpoints de horóscopo diário

Ferramentas de mapa e astrologia

• Cálculo de mapa natal
• Trânsitos
• Sinastria ocidental
• Endpoints de mapa védico
• Endpoints de BaZi chinês

Autenticação, cobrança, administração, webhooks e endpoints de gerenciamento de conta são intencionalmente excluídos do MCP.

Bons Prompts Para Experimentar

Pesquise Paris, França e me dê o fuso horário exato e as coordenadas.

Calcule um mapa natal para 1º de junho de 1990 às 14h30 em Nova York.

Mostre-me a fase lunar atual e explique em linguagem simples.

Obtenha uma tabela de efemérides semanal para Vênus e Marte no zodíaco tropical.

Autenticação

Campo	Valor	Observações
Cabeçalho	x-api-key	Use a mesma chave de API que você já usa para solicitações REST.
Comportamento por nível	igual ao REST	O MCP está incluído em todos os níveis, mas as chamadas ainda contam para seu uso normal e limites de RPS.
Transporte	HTTP Streamable	Escolha uma opção de MCP remoto ou hospedado na sua ferramenta de IA.

Avançado: Chamadas MCP Brutas

A maioria dos usuários nunca precisará disso. Está aqui para ferramentas avançadas, testes e depuração.

Inicializar

curl -X POST "https://api.freeastroapi.com/mcp" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "1.0.0"
      }
    }
  }'

Chamar uma Ferramenta

curl -X POST "https://api.freeastroapi.com/mcp" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "v2_geo_search",
      "arguments": {
        "q": "paris",
        "limit": 3
      }
    }
  }'

Exemplo de Resposta

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"results\": [ ... ],\n  \"count\": 3\n}"
      }
    ],
    "structuredContent": {
      "results": [
        {
          "name": "Paris",
          "country": "FR",
          "lat": 48.85341,
          "lng": 2.3488,
          "timezone": "Europe/Paris",
          "population": 2138551
        }
      ],
      "count": 1
    },
    "metadata": {
      "status_code": 200,
      "path": "/api/v2/geo/search",
      "method": "GET"
    }
  }
}

Solução de Problemas

O Conector Personalizado do Claude Desktop rejeita esta configuração. Baixe a extensão do Claude Desktop acima. O formulário de conector somente URL não pode enviar o cabeçalho x-api-key necessário.

Só vejo configuração de “comando”, não de URL. Esse aplicativo espera um servidor MCP stdio local. Use um aplicativo que suporte MCP remoto ou hospedado.

O servidor conecta, mas as ferramentas falham. Verifique se sua chave de API é válida e não expirou. O MCP usa a mesma chave e os mesmos limites da API normal.

Minha IA diz limite de taxa excedido. As chamadas MCP contam exatamente como solicitações diretas à API. Consulte Limites de Taxa.

Preciso de coordenadas primeiro. Peça à IA para usar a Busca de Cidades antes de solicitar um mapa natal, de trânsito ou de sinastria. A IA pode fazer isso automaticamente pelo MCP.