Skip to content
MCP server

Simple Numerology API

Compute Pythagorean numerology charts, yearly cycles and compatibility for an assistant

Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About Simple Numerology API

Simple Numerology API is a freemium MCP server for astrology. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://simplenumerologyapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "numerology": {
      "url": "https://simplenumerologyapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free plan with 100 requests a month; paid plans raise the limit

Prices change. Check simplenumerologyapi.com before you buy.

Simple Numerology API 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 to Simple Numerology API

  1. Natal Chart Lab

    MCP server

    Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

    Runs locally
    • 5 tools
    • Open source
    • Astrology
  2. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  3. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  4. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments