
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/mcpAdd to Settings → Connectors → Add custom connector
https://simplenumerologyapi.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"numerology": {
"url": "https://simplenumerologyapi.com/mcp"
}
}
}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
Natal Chart Lab
MCP serverKeyless MCP server for planet positions, retrogrades, Moon phases and birth placements
Runs locally- 5 tools
- Open source
- Astrology

Vedic astrology calculations for AI: kundli, guna milan, panchang, dosha and muhurat
- 10 tools
- Remote
- Free
- Astrology

AstroLogics
MCP serverVedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching
- 23 tools
- Remote
- Freemium
- Astrology

GenesisCore Astrology (Western + Vedic)
MCP serverFree Western and Vedic chart signs, retrogrades and ingresses from a date and place
- 4 tools
- Remote
- Free
- Astrology
Céu Natal
MCP serverSwiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese
- 9 tools
- Remote
- Open source
- Astrology

OIYO Korea Calculators
MCP serverDeterministic Korean tax, payroll, labor and calendar calculators served over MCP
- 76 tools
- Remote
- Free
- Finance and payments