# Asterwise MCP server

> Provides 118 astrology and divination tools including Vedic and Western charts, numerology, tarot, and matchmaking for AI agents.

- Repository: https://github.com/asterwise/asterwise-mcp
- Page: https://hostedmcp.org/servers/asterwise/asterwise-mcp
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add --transport http asterwise-mcp https://mcp.asterwise.com/mcp
```

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

```json
{
  "mcpServers": {
    "asterwise-mcp": {
      "url": "https://mcp.asterwise.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "asterwise-mcp": {
      "type": "http",
      "url": "https://mcp.asterwise.com/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"asterwise-mcp","type":"http","url":"https://mcp.asterwise.com/mcp"}'
```

### Codex

```sh
codex mcp add asterwise-mcp --url https://mcp.asterwise.com/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.asterwise-mcp]
url = "https://mcp.asterwise.com/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http asterwise-mcp https://mcp.asterwise.com/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "asterwise-mcp": {
      "url": "https://mcp.asterwise.com/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ASTERWISE_API_BASE_URL` | no | no |  |
| `ASTERWISE_API_KEY` | no | no |  |
| `JWT_SECRET` | no | no |  |
| `MCP_HEADER_AUTHORIZATION` | no | no |  |

## Tools (17)

- `western`
- `natal`
- `factors`
- `numerology`
- `tarot`
- `vedic_reference`
- `numerology_gaps`
- `panchanga`
- `crystals`
- `dasha`
- `matchmaking`
- `horoscope`
- `yoga_dosha`
- `angel_numbers`
- `varshaphal`
- `dreams`
- `panchanga_ext`

## FAQ

### How accurate are the astrology calculations?

Positions are verified against an independent Swiss Ephemeris run and checked against NASA JPL Horizons with a median error of 0.050 arcseconds.
