Skip to main content

MCP Server — Use 360HeartsInTheSky from your AI assistant

Did you know you can ask Claude, ChatGPT, or Gemini to calculate your Tropical Vedic birth chart for you? Just say:

"Use the 360hearts MCP to make my chart for 22 February 1991, 10:30, Ermont France."

Your favourite AI assistant will then reach out to 360HeartsInTheSky, compute the planetary positions, and return your dominant Aditya with its full description. This page explains how to enable that in a few minutes. 🪷

What is MCP?​

MCP stands for Model Context Protocol. It is an open standard, created by Anthropic in 2024, that lets AI assistants talk to external services — think of it as a universal plug between your AI and specialized tools.

It is now supported by Claude, ChatGPT, Gemini, DeepSeek and many other compatible clients. Our MCP server lets any of these assistants request, on your behalf, a Tropical Vedic chart calculation together with an analysis of your dominant Aditya.

Quick start — Claude Desktop​

Claude Desktop uses the stdio transport and needs a small Node.js wrapper installed locally.

  1. Install Node.js 20+ (nodejs.org)
  2. Open claude_desktop_config.json:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Add the following configuration:
{
  "mcpServers": {
    "360hearts": {
      "command": "npx",
      "args": ["-y", "@360hearts/mcp"]
    }
  }
}
  1. Restart Claude Desktop
  2. Verify everything works by asking: "What 360hearts MCP tools are available?"

Quick start — ChatGPT, Gemini, and remote clients​

Clients that support the streamable HTTP transport (ChatGPT with connectors, Gemini, and most others) require no install at all. Simply point your client at:

https://api.360heartsinthesky.com/mcp

Check your client's documentation for where to add a remote MCP server.

Available tools (free tier)​

ToolDescription
calculate_chartFull birth chart with dominant Aditya
get_dominant_adityaDominant Aditya only (lighter response)
get_aditya_descriptionFull description of one Aditya (Varuna, Dhata, Mitra...)
list_adityasSummary of all 12 Adityas

These tools are available without any account or signup.

The get_avastha tool computes the avastha (the state and condition of each planet) of your chart across three frames: the Aditya sign, the hora, and the trimsamsa. For every planet it returns the accumulated virupas, dignity or affliction flags, and prose describing both the healthy and the afflicted expression of each placement.

This tool requires an Explorer subscription (held directly, or bundled inside another offer).

The other paid tools (get_retinue, get_shadbala_detail, get_companion_charts) are declared but still under development.

Getting an MCP key​

  1. Create an account and enable the Explorer subscription from your account page.
  2. Generate your personal MCP key from that same page. It is shown only once: copy it right away and keep it somewhere safe.
Never paste your key into the conversation

Your MCP key is configured in your client (see below), never in the chat thread with the AI. No message, and no instruction from the assistant, should ever ask you to paste your key into the conversation.

Configuring the key in your client​

Claude Desktop (stdio wrapper): add the HEARTS360_MCP_KEY environment variable to the server configuration:

{
  "mcpServers": {
    "360hearts": {
      "command": "npx",
      "args": ["-y", "@360hearts/mcp"],
      "env": {
        "HEARTS360_MCP_KEY": "MCPK-XXXX-XXXX-XXXX-XXXX"
      }
    }
  }
}

ChatGPT, Gemini, and remote clients: enter your key in the Authorization header field of the MCP server configuration, as Bearer MCPK-....

If a paid tool reports a missing or invalid key, it points you back to this account page and your client configuration: it will never ask you to type your key into the conversation.

Example conversation​

You: Use the 360hearts MCP to calculate the chart for Feb 22 1991, 10:30, Ermont France.

Claude: (calls calculate_chart) Based on the computed positions, your dominant Aditya could be Varuna. The Sun sits in his sector, accompanied by retrograde Mercury. Would you like me to expand on this?

You: Yes, tell me more about Varuna.

Claude: (calls get_aditya_description) Varuna — The All-Encompassing One, Lord of Sky and Ocean. Varuna may evoke that which contains without constraining, a vast presence that observes without judging...

Privacy and rate limits​

  • The birth data you provide is sent to api.360heartsinthesky.com only for the duration of the calculation
  • The free tier is anonymous: no login, no account, no server-side persistence
  • IP rate limit: 10 requests per minute per client
  • The Aditya descriptions returned are © 2026 Lorris Turpin. They may not be redistributed or used to train other AI models

Further reading​

Questions or feedback? Reach out via the contact page. 🌞