{
  "markdown": "# Kundlit Vedic Astrology — MCP Server\n\n[![Kundlit MCP server on Glama](https://glama.ai/mcp/servers/@puru991/kundlit-mcp/badge)](https://glama.ai/mcp/servers/@puru991/kundlit-mcp)\n\nFree Vedic astrology computation for AI assistants over the\n[Model Context Protocol](https://modelcontextprotocol.io): daily panchang and\nmuhurta timings for any city, janam kundali birth charts, kundli milan\n(ashtakoot) matching, dosha checks, dasha periods, transits, festival and\neclipse calendars, and Vedic numerology — 17 tools (discovered dynamically),\nplus prompts and documentation resources.\n\nResults are deterministic — computed live with the Swiss Ephemeris on the\nsidereal zodiac (Lahiri ayanamsa) — and backed by classical-text citations\non [kundlit.com](https://kundlit.com).\n\n- **Server URL:** `https://kundlit.com/api/mcp` (hosted, Streamable HTTP)\n- **Auth:** none — no account, no API key\n- **Rate limit:** 30 requests/minute/IP\n- **Docs:** https://kundlit.com/mcp\n- **Privacy:** https://kundlit.com/privacy · **Support:** support@kundlit.com\n\n## Install\n\n### 1. `npx` (works with every client, including stdio-only ones)\n\n```bash\nnpx -y @kundlit/mcp\n```\n\nThat starts a local stdio MCP server which proxies to the hosted endpoint.\nPoint any client at it by command:\n\n**Claude Desktop** — `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kundlit-astro\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kundlit/mcp\"]\n    }\n  }\n}\n```\n\n**Cursor** — `.cursor/mcp.json`, or any client that reads a generic\n`.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kundlit-astro\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kundlit/mcp\"]\n    }\n  }\n}\n```\n\nInstalled globally (`npm i -g @kundlit/mcp`) the binary is `kundlit-mcp`, so\n`\"command\": \"kundlit-mcp\"` with no args works too.\n\n### 2. Direct Streamable HTTP (clients with remote-server support)\n\nNo bridge process needed — connect straight to the URL.\n\n**Claude Code:**\n\n```bash\nclaude mcp add --transport http kundlit https://kundlit.com/api/mcp\n```\n\n**Config file:**\n\n```json\n{\n  \"mcpServers\": {\n    \"kundlit-astro\": {\n      \"type\": \"http\",\n      \"url\": \"https://kundlit.com/api/mcp\"\n    }\n  }\n}\n```\n\n**Claude (web/desktop):** Settings → Connectors → Add custom connector →\n`https://kundlit.com/api/mcp`\n\nFull per-client instructions, example prompts and limitations:\nhttps://kundlit.com/mcp\n\n## What is in this repository\n\nThe npm package `@kundlit/mcp` published from here is a **thin client**: a\nbidirectional JSON-RPC pump between a local `StdioServerTransport` and a\n`StreamableHTTPClientTransport` aimed at `https://kundlit.com/api/mcp`. It\ncontains no astrology logic and no copy of the tool list, so tools added or\nrenamed on the hosted server are picked up with no package update.\n\nFrames are forwarded unmodified in both directions with one deliberate\nexception: if the hop to the hosted server fails, the bridge answers the\npending request locally with a JSON-RPC `-32001` error (`bin/cli.js`) rather\nthan letting the local client hang forever on a reply that is never coming.\nThat error is synthesised by the bridge and was never sent by the server.\n\nThe astrology server itself is hosted at kundlit.com and its source is not\npublic. The manifests here (`.mcp.json`, `server.json`, `.claude-plugin/plugin.json`)\nexist so MCP clients, registries and directories can discover and install it.\n\n### Bridge options\n\n```\nkundlit-mcp [--url <endpoint>]\n\n  --url <endpoint>   Hosted MCP endpoint (default https://kundlit.com/api/mcp).\n                     Also settable via KUNDLIT_MCP_URL; --url wins.\n  -h, --help         Usage and a config snippet.\n  -v, --version      Package version.\n```\n\nstdout carries JSON-RPC and nothing else; all diagnostics, including `--help`\nand `--version` output, go to stderr. Requires Node.js 18 or newer.\n\n### Docker\n\n```bash\ndocker build -t kundlit-mcp .\ndocker run -i --rm kundlit-mcp\n```\n\nThe container speaks MCP over stdio, so run it with `-i` and no TTY.\n\n### Development\n\n```bash\nnpm install\nnode scripts/smoke.mjs   # end-to-end check against the live hosted server\n```\n\n## Capabilities\n\n17 tools, discovered dynamically via `tools/list` — panchang, muhurta and\nchoghadiya windows, janam kundali, ashtakoot matching, manglik / kaal sarp /\nsade sati checks, dasha periods, transits, pancha pakshi, year events,\neclipses, and numerology. Prompts and documentation resources\n(`kundlit://docs/methodology`, `kundlit://docs/usage-guide`) are likewise\ndiscovered at runtime; ask your client to list them rather than relying on a\nlist in this README.\n\n## Example prompts\n\n- \"What is today's panchang in Jaipur? When is rahu kaal?\"\n- \"Make a janam kundali for 14 March 1992, 6:45 am, Lucknow — which mahadasha am I running?\"\n- \"Find me a good time tomorrow in Pune to sign a lease — avoid rahu kaal and bhadra.\"\n- \"All ekadashi dates in 2026 for Varanasi.\"\n\n## Notes\n\n- Free-text `place` (any city worldwide) is preferred; latitude/longitude/IANA\n  timezone also accepted. Year tools snap to the nearest of 50 supported cities.\n- Results are informational and not a substitute for professional advice.\n- Every result carries a `Source:` attribution line — please keep it intact;\n  that attribution is the price of free access.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 5273,
  "sha": "e1553751cd9e3b6a2fbc5ff098b71ffeb39be12e0becec5186638ad30170860a",
  "repo_slug": "puru991/kundlit-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_kundlit_astro_dac88c69/readme"
}