Astroway Mcp

Cline / Continue / Windsurf / Copilot / VS Code MCP

The samenpx @astroway/mcpcommand works in every MCP-compatible client. Drop this block into the client's MCP config file (the path varies by client):

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

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

This MCP serverdoes not phone home. There is no telemetry, no analytics, no usage reporting — and no opt-in / opt-out toggle to maintain. The only network traffic the server originates is the AstroWay API calls you ask it to make, going directly from your machine tohttps://api.astroway.info/v1.

Outgoing requests carry two identifying headers so the AstroWay backend can distinguish MCP traffic from raw HTTP traffic in its own logs:

- User-Agent: astroway-mcp/<version> (Node/<node-version>)
- X-Astroway-Channel: mcp

Neither header carries a session ID, machine fingerprint, or anything personal. They mirror standard HTTPUser-Agentsemantics — every CLI tool sends similar information already.

If you only use part of the catalogue, you can register a subset and keep your LLM context window lean:

{ "env": { "ASTROWAY_API_KEY": "aw_live_...", "ASTROWAY_TOOL_GROUPS": "western,vedic,relational", // only these prefixes "ASTROWAY_READONLY": "1" // skip ai/horoscope/reports (LLM-backed, costs credits) } }

Common groups:western,vedic,tarot,numerology,hd(Human Design),relational(synastry/composite/davison),prognostics(transits/progressions/returns),aspects,horary,geo,chinese,bazi,mayan,iching,runes,geomancy. Runnpx @astroway/mcp --list-toolsto inspect the full set; the boot-linefilters: …field shows what was applied.

ASTROWAY_READONLY=1skips the three groups that internally call an LLM (ai,horoscope,reports) — useful when you want pure deterministic chart math without burning credits on text generation.

If your agent hits context or tool-count limits with the full catalogue, setASTROWAY_DISCOVERY_MODE=1. Instead of registering 600+ tools up front, the server exposes just two meta-tools:

- astroway_find_tool(query, limit?)— keyword-search the whole catalogue; returns the best-matching tools with their one-line description and input parameter names.
- astroway_call_tool(name, arguments?)— invoke any tool the search surfaced.

The agent discovers the right tool on demand, then calls it — reaching the entire catalogue from a two-tool footprint.

Trade-off: a tool dispatched throughastroway_call_toolreturns its result astext only. A runtime-dispatched call cannot declare a per-calloutputSchema, so it can't carry the validatedstructuredContentthat directly-registered tools provide. LeaveASTROWAY_DISCOVERY_MODEunset (the default) when you want typed structured output; use it when tool-count pressure matters more. Discovery supersedesASTROWAY_TOOL_GROUPS/ASTROWAY_READONLY.

- Catalogue is frozen for the duration of a session.The 624 tools, 12 prompts, and 14 resources are baked into the published npm package — they don't change at runtime. (The MCPlistChangedcapability is advertised by the SDK, but no/list_changednotification is ever emitted by this build. If your client caches the catalogue after the firsttools/listit will stay correct for the whole connection.)
- Tool identifiers are stable inside a major version.A name shipped underastroway_<group>_<tool>won't be renamed or removed within the samev0.xminor without a deprecation note inCHANGELOG.md. Across major bumps (v1→v2) any breaking change is announced and the legacy escape (MCP_FLAT_TOOLS=1) carries you across one minor.
- Tool input shape is stable inside a minor version.Tightening (regex, range, enum) ships in patches; adding required fields requires a minor bump.
- Refresh the catalogue by reinstalling.npm i -g @astroway/mcp@latest(or thenpx -y @astroway/mcpform already in your client config) pulls the current set on the next start.
- Open the MCP indicator (bottom of the chat input in Claude Desktop, status bar in Cursor).
- You should seeastrowaylisted as an active server.
- Hover or click — the badge shows624 tools registered + 12 prompts + 14 resources(counts as of the latest release).
- Cold-start takes 2-3 seconds the first time (Node + TLS handshake to api.astroway.info).
- Sanity check from any terminal:npx @astroway/mcp --versionprints the package version,npx @astroway/mcp --list-tools synastryprints matching tools.

Tools returnError 401.API key is missing, invalid, or revoked. Generate a new one athttps://api.astroway.info/dashboard/keys.

Tools returnError 402.Out of credits on the free tier. Upgrade athttps://api.astroway.info/pricing/or wait for the monthly reset.

- 📦 npm:https://www.npmjs.com/package/@astroway/mcp
- 📘 API docs:https://api.astroway.info/docs/api/
- 🔑 Sign up & dashboard:https://api.astroway.info/dashboard/
- 💰 Pricing:https://api.astroway.info/pricing/
- 🌐 Website:https://astroway.info

Fetches daily Wordle solutions using the official Wordle API.