Claude Desktop

Connect the AstroWay API to Claude Desktop over MCP. Both transports work: hosted (HTTP) and the local stdio package.

Prerequisites

Get an API key in the dashboard. For free testing use a sandbox aw_test_* key — it doesn’t spend credits.

Setup

Open Settings → Developer → Edit Config — Claude Desktop reveals the path to claude_desktop_config.json. Paste one of the blocks below and restart Claude Desktop.

Hosted (HTTP) — zero install, Bearer-token auth:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx) — local subprocess, env-var auth, offline-ready:

claude_desktop_config.json

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

Verify

Tell Claude in chat: “List the AstroWay tools” — or ask it to call a free reference tool, such as fetching the list of zodiac signs. If a result comes back, the connection works.

Troubleshooting

• 401 / invalid key — make sure the key is prefixed aw_live_* or aw_test_* and isn’t revoked. Check it in the dashboard.
• Tools don’t appear — fully restart Claude Desktop (quit it, don’t just close the window) and verify the path to claude_desktop_config.json.
• -32602 validation errors (stdio) — update the package: npm i @astroway/mcp@latest. Schemas are regenerated from the live spec.

See all clients — Agent setup.