Kundlit Vedic Astrology — MCP Server

Free Vedic astrology computation for AI assistants over the Model Context Protocol: daily panchang and muhurta timings for any city, janam kundali birth charts, kundli milan (ashtakoot) matching, dosha checks, dasha periods, transits, festival and eclipse calendars, and Vedic numerology — 17 tools (discovered dynamically), plus prompts and documentation resources.

Results are deterministic — computed live with the Swiss Ephemeris on the sidereal zodiac (Lahiri ayanamsa) — and backed by classical-text citations on kundlit.com.

• Server URL: https://kundlit.com/api/mcp (hosted, Streamable HTTP)
• Auth: none — no account, no API key
• Rate limit: 30 requests/minute/IP
• Docs: https://kundlit.com/mcp
• Privacy: https://kundlit.com/privacy · Support: support@kundlit.com

Install

1. npx (works with every client, including stdio-only ones)

npx -y @kundlit/mcp

That starts a local stdio MCP server which proxies to the hosted endpoint. Point any client at it by command:

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "kundlit-astro": {
      "command": "npx",
      "args": ["-y", "@kundlit/mcp"]
    }
  }
}

Cursor — .cursor/mcp.json, or any client that reads a generic .mcp.json:

{
  "mcpServers": {
    "kundlit-astro": {
      "command": "npx",
      "args": ["-y", "@kundlit/mcp"]
    }
  }
}

Installed globally (npm i -g @kundlit/mcp) the binary is kundlit-mcp, so "command": "kundlit-mcp" with no args works too.

2. Direct Streamable HTTP (clients with remote-server support)

No bridge process needed — connect straight to the URL.

Claude Code:

claude mcp add --transport http kundlit https://kundlit.com/api/mcp

Config file:

{
  "mcpServers": {
    "kundlit-astro": {
      "type": "http",
      "url": "https://kundlit.com/api/mcp"
    }
  }
}

Claude (web/desktop): Settings → Connectors → Add custom connector → https://kundlit.com/api/mcp

Full per-client instructions, example prompts and limitations: https://kundlit.com/mcp

What is in this repository

The npm package @kundlit/mcp published from here is a thin client: a bidirectional JSON-RPC pump between a local StdioServerTransport and a StreamableHTTPClientTransport aimed at https://kundlit.com/api/mcp. It contains no astrology logic and no copy of the tool list, so tools added or renamed on the hosted server are picked up with no package update.

Frames are forwarded unmodified in both directions with one deliberate exception: if the hop to the hosted server fails, the bridge answers the pending request locally with a JSON-RPC -32001 error (bin/cli.js) rather than letting the local client hang forever on a reply that is never coming. That error is synthesised by the bridge and was never sent by the server.

The astrology server itself is hosted at kundlit.com and its source is not public. The manifests here (.mcp.json, server.json, .claude-plugin/plugin.json) exist so MCP clients, registries and directories can discover and install it.

Bridge options

kundlit-mcp [--url <endpoint>]

  --url <endpoint>   Hosted MCP endpoint (default https://kundlit.com/api/mcp).
                     Also settable via KUNDLIT_MCP_URL; --url wins.
  -h, --help         Usage and a config snippet.
  -v, --version      Package version.

stdout carries JSON-RPC and nothing else; all diagnostics, including --help and --version output, go to stderr. Requires Node.js 18 or newer.

Docker

docker build -t kundlit-mcp .
docker run -i --rm kundlit-mcp

The container speaks MCP over stdio, so run it with -i and no TTY.

Development

npm instal

... [View full README on GitHub](https://github.com/puru991/kundlit-mcp#readme)