AI Agent Setup

MCP Server Usage

Connect Claude or any AI assistant to Jagannatha Hora's Vedic calculation engine — in three simple steps.

Copy the server URL, download the guide, and paste both into your AI client. The agent reads the guide and figures out which tool to call for each question.

Download MCP Guide

Also see REST API reference.

MCP Server URL

Paste this URL wherever your AI assistant asks for an MCP server URL. No API key or token is needed — the endpoint is open for anyone setting up their AI client.

https://jagannatha-hora-359167915530.europe-west1.run.app/mcp

What Your AI Can Access

Once connected, the AI can call any of these calculation tools on its own and combine them to answer astrology questions.

Birth Chart & Planets

Full horoscope, planetary positions, nakshatras, arudha padas, and special lagnas from any birth details.

Dashas & Life Timing

Vimshottari, Yogini, and Ashtottari dashas with configurable sub-period depth for timing predictions.

Divisional Charts

All Varga charts from D-1 through D-60 with placements, house lords, and division-specific rulers.

Marriage Matching

Kuta analysis, Guna Milan, Dosha checks, and compatibility scoring for match questions.

Transits & Muhurta

Gochara, Saturn transit windows, planet ingress dates, and muhurta events in a chosen window.

Yogas, Doshas & Strengths

Shad Bala, Bhava Bala, Ashtakavarga, Vimsopaka bala, doshas, and classical yoga detection.

Set It Up In 3 Steps

Step 1

Copy the server URL

Copy the MCP server URL from the card below. This is the address your AI assistant connects to.

Step 2

Download the guide

Download the Markdown guide. It tells the AI what the server can do and how to call each tool.

Step 3

Give both to Claude

In Claude Desktop, open Settings, add a new MCP connector, paste the URL, and attach the guide. Claude handles the rest.

Full Tool Catalog

The server currently exposes these tools, grouped by area. Your AI client discovers them at runtime with tools/list, so the live schema is always authoritative.

Birth chart & positions

generate_horoscopeget_nakshatra_padaget_planetary_statesget_special_lagnas

Dashas & longevity

get_dashaget_longevity

Divisional charts

list_divisional_chartsget_divisional_chartget_house_varnadas

Marriage & matching

get_marriage_match

Transits & muhurta

get_gocharaget_gochara_rangeget_planet_ingressget_muhurtaget_saturn_transit

Yogas & doshas

get_yogasget_doshas

Strengths (bala)

get_shad_balaget_bhava_balaget_other_balaget_vimsopaka_balaget_vaiseshikamsa_balaget_ashtakavarga

Arudhas & special points

get_arudha_padasget_graha_arudhasget_surya_arudhasget_chandra_arudhasget_chara_karakasget_sphutasget_upagrahasget_amsa_rulersget_sahams

Ask Your AI Anything Like This

Once the connector is set up, you don't need to know which tool to call. Just ask naturally — the AI picks the right tool and reads the answer back to you.

Tell me about my current Vimshottari mahadasha and what to expect from the antardasha.
Am I in Sade Sati right now? When does it end?
Do these two charts match by Ashtakoota? Which kutas are weak?
Show me my D-9 (navamsa) chart and highlight the ascendant lord's placement.
What are the strongest yogas in my birth chart?
Find an auspicious muhurta for a business opening in the next 60 days.
Which planets are exalted, debilitated, or retrograde in my chart?
Do I have Manglik dosha? What does the engine say about it?

Compatible AI Clients

Anything that speaks the Model Context Protocol works. The clients below are the ones we've tested against.

Claude Desktop

The primary supported client. Add the URL as an MCP connector in Settings and attach the downloaded guide.

Custom MCP clients

Any client that speaks the Model Context Protocol JSON-RPC 2.0 wire format will work. Point it at the server URL and call tools/list to discover the schema.

Anthropic API integrations

If you are building your own agent on top of the Claude API, use the MCP client library and connect to the same URL. Same tools, same guide.