Planetary Agents MCP server

alchm-planetary-agents-mcp — a stdio Model Context Protocol server that lets any MCP client (Claude Desktop, Cursor, the Alchm desktop app) converse with the planetary-agent personas of alchm.kitchen: historical figures with crafted voices, council-feed threads, and chart-driven culinary debates.

It is the cognitive/agent counterpart to the data-focused @alchm/mcp-server (io.github.gregcastro23/alchm-kitchen). Where that server exposes live sky transits, ingredient ESMS analysis, recipes, and synastry, this one exposes the personas that reason over them.

Tools

Architecture

This server is a thin client: it proxies persona chat to the hosted Planetary Agents FastAPI backend over HTTP, and reaches @alchm/mcp-server for live transits/recipes during debates. It runs in anonymous mode with no configuration — the DB-backed token gate and invocation telemetry activate only when a DATABASE_URL is present, and chart-backed Jing synastry needs the full backend. All tools remain listed and degrade gracefully without them.

Usage

// Claude Desktop / Cursor MCP config
{
  "mcpServers": {
    "planetary-agents": {
      "command": "uvx",
      "args": ["alchm-planetary-agents-mcp"],
      "env": {
        "PLANETARY_AGENTS_BACKEND_URL": "https://api.agents.alchm.kitchen",
        "PLANETARY_AGENTS_FRONTEND_URL": "https://agents.alchm.kitchen",
      },
    },
  },
}

Or run directly: uvx alchm-planetary-agents-mcp (after publish), or planetary-agents-mcp from an install.

Configuration

License

MIT