For Developers

Lumin helps your business serve every customer

Career, finance, health, relationships, timing. Lumin reads each user's birth chart and builds a specific answer to whatever they ask, with the evidence behind every one.

Read the full developer docs

Quick start with Claude Code

Add Lumin in one command

Already building in your codebase with Claude Code? Add Lumin, then sign in with your email address and the six digit code we send you. No password, and the free plan includes 300 tool calls a month:

claude mcp add --transport http lumin-kp https://mcp.lumin.guru/mcp

Running it service to service? Same URL, send an API key from your developer panel instead of signing in:

claude mcp add --transport http lumin-kp https://mcp.lumin.guru/mcp \
  --header "Authorization: Bearer mcp_yourkey..."

Ask Lumin what it can do for you

Ask Claude Code "what can Lumin do for this product?" and it calls the tools to show what fits. See the documentation for details.

Runs inside the Claude Code you already use, at no extra cost. The free plan includes 300 tool calls a month, and prepaid call packs cover heavier use. See pricing for details.

Recommended model

For precision

Claude Opus 4.7

Adaptive thinking on, or higher

Best for marriage timing, foreign settlement, medical timing, legal questions, and rectification. The full seven-phase chain holds together at synthesis.

For general questions

Claude Sonnet

Adaptive thinking on

Faster and lighter. Good default for follow-up questions in an existing reading, horary lookups, panchang checks, and quick chart summaries.

Server details

Protocol: MCP (Streamable HTTP)

Server URL: https://mcp.lumin.guru/mcp

Tools: 158 astrology computations, 8 of them composite workflows

Auth: API key or OAuth 2.1, required on every request

Status: Health check

Privacy: Privacy policy

Support: contact@lumin.guru

Free consultation

Find where Lumin fits your stack

Already running a product, website, or live chat experience? We'll help you see how Lumin can elevate what your users get out of it, with sharper, more personal answers worth coming back for.

Book a call

30 minutes · No credit card · We reply within a day or two

What to expect

A walk-through of where Lumin fits in your stack
Examples tuned to your audience and use case
An honest read on whether it makes sense for you