# AstroWay API Docs

> AstroWay API Docs is a freemium MCP server for astrology. Search AstroWay API docs and look up endpoint credit prices from your AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** API
- **Website:** https://api.astroway.info/en/examples/mcp/
- **MCP Registry name:** info.astroway/docs
- **Categories:** astrology, developer tools
- **Listing updated:** 2026-11-15

## About

AstroWay sells an astrology and esoteric calculation API, and its full tool server exposes 843 endpoints as tools. This docs server is the lightweight sibling: instead of calculating charts, it lets an assistant search the API documentation and find the right endpoint along with what a call costs in credits.

The registry entry says it needs no API key, and it is served over Streamable HTTP from the mcp.astroway.info host. That makes it a handy first stop before you decide which endpoint groups to wire into an app, since credit prices range from 5 credits for cached reference lookups to thousands for PDF reports.

It suits developers building horoscope, natal chart, Vedic, Human Design or tarot features who want an assistant to answer "which endpoint do I call, and what will it cost?" without pasting docs into the chat.

## Features

- **Documentation search:** Finds relevant pages of the AstroWay API documentation from a plain-language query.
- **Endpoint lookup:** Returns the endpoint that matches a task so the assistant can point to the right path.
- **Credit prices:** Shows how many credits an endpoint call costs; tiers run from 5 credits for cached reference data to 5,000 for PDF reports.
- **No API key:** The registry entry states that the docs server works without a key.
- **Remote HTTP server:** Connects by URL over Streamable HTTP, so nothing needs installing.

## Good for

- Choosing which AstroWay endpoint fits a natal chart or transit feature
- Estimating the credit cost of an astrology app before building it
- Letting a coding assistant look up request shapes while you write integration code
- Comparing the cost of Western, Vedic and Human Design calls

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http docs https://mcp.astroway.info/mcp/docs
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.astroway.info/mcp/docs
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "docs": {
      "url": "https://mcp.astroway.info/mcp/docs"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "docs": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/docs"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "docs": {
      "serverUrl": "https://mcp.astroway.info/mcp/docs"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "docs": {
      "type": "http",
      "url": "https://mcp.astroway.info/mcp/docs"
    }
  }
}
```

## FAQ

### Do I need an API key for the docs server?

The registry entry says no API key is needed for documentation search and endpoint lookup.

### How do credit prices work?

Each endpoint costs a fixed number of credits, from 5 for cached reference lookups up to 5,000 for PDF reports. The free plan includes 10,000 credits a month.

### Where is the server hosted?

At https://mcp.astroway.info/mcp/docs over Streamable HTTP.

### Is this the same as the full AstroWay MCP server?

No. The full hosted server exposes the whole API as 843 tools and needs an AstroWay key; this one only covers documentation and pricing.

### Is AstroWay API Docs free?

AstroWay API Docs has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

### How do I add AstroWay API Docs to Claude Code?

Run this command in your terminal: claude mcp add --transport http docs https://mcp.astroway.info/mcp/docs

### What are the best alternatives to AstroWay API Docs?

The closest alternatives to AstroWay API Docs are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/astroway-api-docs
