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 following tools are already declared but currently return "subscription required":

  • get_retinue — Full retinue (Rishi, Gandharva, Apsara, Yaksha, Rakshasa, Naga) of the dominant Aditya
  • get_shadbala_detail — Detailed analysis of the six planetary strengths
  • get_companion_charts — Companion Aditya charts for deeper study

These features may unlock in a future subscription tier.

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) VarunaThe 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. 🌞