# Simple Numerology API

> Simple Numerology API is a freemium MCP server for astrology. Compute Pythagorean numerology charts, yearly cycles and compatibility for an assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://simplenumerologyapi.com/numerology-mcp-server
- **MCP Registry name:** com.simplenumerologyapi/numerology
- **Categories:** astrology
- **Listing updated:** 2026-11-15

## About

A chat model often sums digits in the wrong order, drops a master number or treats Y inconsistently, so this server hands the arithmetic to an API and leaves the explaining to the model. Four tools cover a full chart, personal cycles, compatibility and account status, plus a resource listing the calculation conventions so the model can say why a number is what it is.

The chart has 47 fields, including life path, destiny, soul urge, pinnacles, challenges and karmic debts. Cycles can look up to 10 years ahead, and compatibility returns a 0 to 100 score with the reason for each pairing. The conventions are fixed: Y is a consonant, names are reduced as a whole and master numbers 11, 22 and 33 are kept. Accented, Cyrillic and special Latin letters are handled.

Calls run against your Simple Numerology API account, so the free plan's 100 requests a month apply. Sign-in is by OAuth, or an API key as a bearer token, and names and birthdates are used for the answer rather than stored.

## Features

- **Full chart:** Returns a 47-field Pythagorean chart.
- **Personal cycles:** Gives year, month and day cycles and up to 10 years ahead.
- **Compatibility score:** A 0 to 100 score with the reason for each pairing.
- **Conventions resource:** Lets the model explain how numbers were derived.
- **Text or JSON output:** A readable summary or the full API response.
- **Any alphabet:** Handles accents, special Latin letters and Cyrillic.

## Good for

- Find the life path number of a named person
- See which personal year is coming up
- Compare two people's charts
- Draft a reading grounded in correct numbers
- Check how many requests remain this month

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http numerology https://simplenumerologyapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://simplenumerologyapi.com/mcp
```

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

```json
{
  "mcpServers": {
    "numerology": {
      "url": "https://simplenumerologyapi.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "numerology": {
      "type": "http",
      "url": "https://simplenumerologyapi.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "numerology": {
      "serverUrl": "https://simplenumerologyapi.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "numerology": {
      "type": "http",
      "url": "https://simplenumerologyapi.com/mcp"
    }
  }
}
```

## Tools

- `get_numerology_chart`: Returns a full Pythagorean numerology chart.
- `get_personal_cycles`: Returns personal cycles and upcoming years.
- `get_compatibility`: Scores compatibility between two people.
- `get_account_status`: Shows plan and quota left; uses no quota.

## FAQ

### Is the free plan enough to try it?

Yes, the free plan covers 100 requests a month, and the status tool uses none.

### Which system does it use?

Pythagorean numerology with documented conventions.

### Do I need to install anything?

No, the server is hosted; add its URL to your assistant.

### Are names kept?

The account records the number of requests, not their contents.

### Is Simple Numerology API free?

Simple Numerology API has a free plan, with paid plans for more usage or features.

### How do I add Simple Numerology API to Claude Code?

Run this command in your terminal: claude mcp add --transport http numerology https://simplenumerologyapi.com/mcp

### What are the best alternatives to Simple Numerology API?

The closest alternatives to Simple Numerology API are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and Céu Natal.

## Alternatives

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [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.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/simple-numerology-api
