AI Agents & MCP

Building an AI agent that needs real astrology calculations instead of hallucinations? AstroWay plugs into Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral - via MCP, llms.txt, or direct HTTP. Two integration paths: MCP server (zero-code for Claude Desktop, Cursor IDE, Windsurf, VS Code llm CLI, and any MCP-compatible client - including GPT with MCP via OpenAI Realtime API) or HTTP API (for any agent framework - LangChain, LlamaIndex, AutoGen, CrewAI).

Path 1: MCP server (recommended)

Model Context Protocol (MCP) is an open standard for connecting tools to AI models. The hosted AstroWay MCP server exposes 843 tools, one per API operation, plus 12 prompts and 14 resources.

Claude Desktop setup

Add to claude_desktop_config.json:

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

After restarting Claude Desktop, it will see all 735 tools of the npm package. To keep the list short, set ASTROWAY_TOOL_GROUPS or use a domain server, see MCP setup.

What the MCP server can do

Tool	What it does
astroway_western_chart	Calculate natal chart
astroway_relational_synastry	Two-person synastry
astroway_horoscope_daily	Daily horoscope
astroway_ai_interpret_natal	AI interpretation of natal chart
astroway_hd_human_design	Full HD chart
astroway_prognostics_transits	Current transits

Full list: 843 tools on the hosted server, the whole API, 795 of them with a typed output schema.

Example dialog with Claude

User: Build a natal chart for someone born July 14, 1990 at 14:30 in Kyiv. What does Sun in Cancer in the 10th house mean?

Claude: Uses astroway_western_chart to calculate, then astroway_ai_interpret_placement for interpretation. Returns planet positions with real data and a meaningful interpretation.

Path 2: HTTP API

For AI agents without MCP support - use HTTP API directly.

For content generation

// AI agent calls /interpret/natal for interpretation
const interpretation = await fetch('https://api.astroway.info/v1/interpret/natal', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});

const { data: result } = await interpretation.json();
// result.interpretation - ready AI interpretation
// result.disclaimer - disclaimer for display

For calculations + your own LLM

// 1. Get raw data via /chart (cheaper - 20 credits)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const { data } = await chart.json();

// 2. Pass data to your LLM
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

Tip

If you only need the interpretation - use /interpret/* (50 credits, text ready). If you want to control the prompt - use /chart (20 credits) and pass the data to your LLM.

Use cases

Personal astrology assistant

MCP server + Claude/ChatGPT. User asks - agent calculates and interprets. Budget: Free tier for personal use.

Social media content bot

Daily horoscope generation for 12 signs via /horoscope/daily. 12 requests per day = 240 credits. Free tier with plenty of headroom.

AI coaching platform

/interpret/natal + /interpret/transits per client. 100 clients/day = 10,000 credits/day. Pro plan.

Quick start → First request in 5 minutes

Horoscope API AI interpretations & horoscopes

Pricing From Free to Enterprise