Astrovisor MCP — AI skill for Claude Code

AstroVisor MCP

[](https://www.npmjs.com/package/astrovisor-mcp) [](LICENSE) [](package.json)

AstroVisor MCP connects MCP-compatible AI clients to the complete AstroVisor API. It supports local stdio and production Streamable HTTP, discovers operations from the live OpenAPI document, and returns large calculation results through a compact, queryable response layer.

This repository is the protocol and server layer. For reusable personal workflows, private people profiles, interactive credential setup, and safe AI request construction, install the separate [AstroVisor Skill](https://github.com/rokoss21/astrovisor-skill).

[!IMPORTANT] AstroVisor calculations require a personal dashboard API key beginning with `pk-`. Anonymous calculation requests are not supported. Create an account and get your API key at [astrovisor.io](https://astrovisor.io/), then provide it to your MCP client through a secure environment variable or the AstroVisor Skill private credential setup.

Configure the API key

For a direct MCP connection, make the key available to the client process:

export ASTROVISOR_API_KEY="pk-..."

For the safer profile-aware setup, install [AstroVisor Skill](https://github.com/rokoss21/astrovisor-skill) and use its hidden key prompt:

npx --yes --package=astrovisor-skill@1.0.1 -- \
  astrovisor-skill install --target both

node "$HOME/.agents/skills/astrovisor/scripts/astrovisor-skill.mjs" \
  config set-key

node "$HOME/.agents/skills/astrovisor/scripts/astrovisor-skill.mjs" \
  doctor --json

You can also ask your agent:

Use $astrovisor. Help me securely configure my AstroVisor API key, keep it out of
chat and client configuration, then verify the MCP connection.

The agent should guide you to the hidden terminal