# StarMeet MCP Server

A [Model Context Protocol](https://modelcontextprotocol.io) server providing Vedic astrology tools to AI assistants (Claude, Cursor, Continue, etc.).

## Tools

| Tool | Description |
|------|-------------|
| `calculate_kundali` | Vedic birth chart (D1) preview — Ascendant, Sun/Moon signs & houses, Moon nakshatra, current Dasha |
| `get_panchang` | Daily Panchang — Tithi, Nakshatra, Yoga, Karana, Rahu Kaal, Abhijit Muhurta, sunrise/sunset |
| `get_nakshatra` | Detailed nakshatra profile (ruling planet, gana, deity, symbol, keywords, compatibility notes) |

All tools powered by [star-meet.com](https://star-meet.com) Vedic Astrology Engine.

## Quick Start

```bash
npx @edestory/mcp-starmeet
```

Or add to Claude Desktop `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "starmeet": {
      "command": "npx",
      "args": ["@edestory/mcp-starmeet"]
    }
  }
}
```

## Example Usage (Claude)

> "Calculate the Vedic birth chart for someone born on March 15, 1990 at 10:30 AM in Delhi"

Claude will call `calculate_kundali` → star-meet.com API → return full D1 chart.

> "What is today's panchang for Mumbai?"

Claude will call `get_panchang` → star-meet.com API → return Tithi, Nakshatra, Rahu Kaal.

## API

All requests proxied to `https://star-meet.com/star-api/v1`. No API key required.

## License

MIT — [star-meet.com](https://star-meet.com)