Agents

Last updated 14 October 2026

An agent such as Claude, ChatGPT or Cursor can read your chart and journal, ask Hermes, and prepare an Atelier cart, only after you allow it. You confirm every purchase yourself.

The address

The server is https://zodial.ai/mcp. It speaks the Model Context Protocol over streamable HTTP. The agent signs in with your Zodial passkey. Zodial does not give the agent a password, and you should not paste a token into a settings file.

Claude

Open Customize, then Connectors, then Add custom connector. Paste https://zodial.ai/mcp. Choose OAuth and register automatically. When the browser asks, allow the redirect to https://claude.ai/api/mcp/auth_callback.

ChatGPT

Open Settings, then Connectors, then Create. Paste the same URL and choose OAuth. ChatGPT uses https://chatgpt.com/connector_platform_oauth_redirect when Zodial returns the issuer on the way back.

Cursor

Open Cursor Settings, then Tools and MCPs, then New MCP server. Or add this to mcp.json:

{
  "mcpServers": {
    "zodial": { "url": "https://zodial.ai/mcp" }
  }
}

Cursor opens the browser. Sign in there. Leave the file without an Authorization header.

What you can allow

• Read your chart and readings. Sign and house, today's reading, transits, planetary hours and the lunar mansion. Not the birth date, time or place.
• Read your Journal and write to your Journal. Notes are stored as you, or the agent, wrote them.
• Ask Hermes. Each question uses your Hermes allowance, the same spend caps, and the fallback model when the primary is resting.
• Manage clocks and Constellation. The agent can list and save clocks. It cannot change a birth time. Constellation stays on your device.
• Change digest and notification settings. The morning digest, and Hermes nudge channels. Not Orbit.
• Atelier: build a cart. The agent returns a checkout link. Nothing is charged until you open it and pay.

Planetary hours and the sky for a city are public. They do not use your account.

Orbit, payments and birth-time changes are never available to agents. Teams is not available to an agent on a personal account.

After you connect

Under Account › Connected agents you can see each agent, change what it may do, read its activity for today, 7 days or 30 days, and disconnect it. Disconnecting revokes the tokens at once. A call that was not allowed, or that hit a limit, is marked in that list.

Zodial can limit how often an agent calls, and can turn agents off. While they are off, new connections and tool calls stop. Refreshing a token does not make a call succeed.

What Zodial stores

The agent name, the permissions you granted, a hash of each token, and a log of the time, the tool and the result. The token itself is not stored. The Privacy Policy describes this in full.