# Lucernel Public Tools

> Lucernel Public Tools is an open-source MCP server for astrology. Five free public tools: destiny matrix, angel numbers, Bible verses and seeded names. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://lucernel.com
- **Repository:** https://github.com/lucernel/public-apis
- **MCP Registry name:** io.github.Lucernel/public-tools
- **Categories:** astrology, religion
- **Listing updated:** 2026-11-15

## About

Lucernel Public Tools bundles five small, unauthenticated JSON operations from four independent sites, run locally over stdio from the @lucernel/public-tools npm package. They are personal and couple matrix calculations from Matrice del Destino, a date-based angel number from Istruzione Messina, the daily World English Bible verse from Lucernel, and seeded name generation from Musael.

The README says they use existing site calculations or data and do not require authentication, call AI services or touch application databases. Premium Matrice readings and PDFs, private account data and Musael manuscripts are outside this API. Each site has its own origin and quota, and it asks callers to honour Retry-After on 429 or 503 and not to evade quotas.

Lucernel itself describes the maker as an independent house building SaaS, iPhone apps and web apps. The toolkit is MIT licensed and needs Node.js 22 or later for the CLI.

## Features

- **Destiny matrices:** Personal and couple matrix calculations.
- **Angel number:** A number derived from a date.
- **Verse of the day:** The daily World English Bible verse.
- **Seeded names:** Name generation from a seed.
- **No auth:** Direct endpoints are free with no key or paid tier.
- **CLI included:** The package also ships a lucernel-tools CLI.

## Good for

- Fetch the verse of the day for an app
- Calculate a couple's destiny matrix
- Generate repeatable names from a seed
- Look up an angel number for a date

## Install

### Claude Code (Terminal)

```sh
claude mcp add public-tools -- npx -y @lucernel/public-tools
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "public-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@lucernel/public-tools"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "public-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@lucernel/public-tools"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "public-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@lucernel/public-tools"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "public-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@lucernel/public-tools"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "public-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@lucernel/public-tools"
      ]
    }
  }
}
```

## FAQ

### Do I need an account or key?

No. The direct API endpoints are free with no login, key or subscription.

### What does it run on?

The package runs locally over stdio; the CLI needs Node.js 22 or later.

### Does it call AI services?

No, according to the README.

### What licence is it?

MIT.

### Is Lucernel Public Tools free?

Yes. Lucernel Public Tools is open source, so you can use and self-host it for free.

### How do I add Lucernel Public Tools to Claude Code?

Run this command in your terminal: claude mcp add public-tools -- npx -y @lucernel/public-tools

### What are the best alternatives to Lucernel Public Tools?

The closest alternatives to Lucernel Public Tools are Madeenan Quran and Hadith Sources, Natal Chart Lab, SalahTable, VedicDost: Vedic Astrology, Kundli & AI Astrologer and AstroLogics.

## Alternatives

- [Madeenan Quran and Hadith Sources](https://ai-powered.com/mcp/madeenan-quran-and-hadith-sources): Madeenan Quran and Hadith Sources is a freemium MCP server for religion.
- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [SalahTable](https://ai-powered.com/mcp/salahtable): SalahTable is a free MCP server for religion.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [Céu Natal](https://ai-powered.com/mcp/ceu-natal): Céu Natal is an open-source MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/lucernel-public-tools
