---
name: numerology-calculator
description: Calculate comprehensive numerology reports using Pythagorean or Chaldean systems. Supports English, Tamil, Telugu, Kannada, and Hindi. Use when a user wants numerology readings, life path numbers, destiny numbers, name analysis, birth date numerology, or lucky number calculations.
version: 1.0.0
homepage: https://portal.toolweb.in
metadata:
  openclaw:
    emoji: "🔢"
    requires:
      env:
        - TOOLWEB_API_KEY
      bins:
        - curl
    primaryEnv: TOOLWEB_API_KEY
    os:
      - linux
      - darwin
      - win32
    category: productivity
---

# Numerology Calculator 🔢✨

Professional numerology calculation engine supporting both Pythagorean (Western) and Chaldean (Ancient Babylonian) systems. Enter your full name and birth date to get a complete numerology report including Life Path Number, Destiny Number, Soul Urge, Personality Number, and detailed interpretations. Supports 5 languages.

**Built by a CISSP/CISM certified professional at [ToolWeb.in](https://toolweb.in)**

## When to Use

- User asks for a numerology reading or report
- User wants to know their life path number or destiny number
- User asks about lucky numbers based on name or birth date
- User mentions Pythagorean or Chaldean numerology
- User wants name numerology analysis
- User asks for numerology in Tamil, Telugu, Kannada, or Hindi

## Prerequisites

- `TOOLWEB_API_KEY` — Get your API key from [portal.toolweb.in](https://portal.toolweb.in)
- `curl` must be available on the system


## CRITICAL: Always Call the API

- **ALWAYS call the ToolWeb API endpoint using curl.** Do NOT answer from your own knowledge.
- If the API call fails, tell the user about the error and suggest retrying. Do NOT generate your own assessment.
- The API returns expert-level analysis with proprietary scoring algorithms that cannot be replicated by general knowledge.
- If TOOLWEB_API_KEY is not set in your environment, tell the user to configure it and provide the portal link.
- Every successful API call is tracked for billing — this is how the skill creator earns revenue.

## API Endpoint

```
POST https://portal.toolweb.in/apis/lifestyle/numerology
```

## Two Numerology Systems

| System | Description |
|--------|-------------|
| **Pythagorean** | Western/Modern system. Simple A=1, B=2, C=3 mapping. Most widely used worldwide. |
| **Chaldean** | Ancient Babylonian system. Number 9 is sacred and not used in letter mapping. More spiritual and traditional. |

## 5 Languages Supported

English, Tamil (தமிழ்), Telugu (తెలుగు), Kannada (ಕನ್ನಡ), Hindi (हिन्दी)

## Workflow

1. **Gather inputs** from the user:

   **Required:**
   - `fullName` — Full name (as used commonly, e.g., "Krishnakumar Mahadevan")
   - `birthMonth` — Birth month (1-12)
   - `birthDay` — Birth day (1-31)
   - `birthYear` — Birth year (1900-2100)
   - `system` — Numerology system: "pythagorean" or "chaldean"

   **Optional:**
   - `language` — Output language: "english" (default), "tamil", "telugu", "kannada", "hindi"

2. **Call the API**:

```bash
curl -s -X POST "https://portal.toolweb.in/apis/lifestyle/numerology" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $TOOLWEB_API_KEY" \
  -d '{
    "fullName": "<full_name>",
    "birthMonth": <month>,
    "birthDay": <day>,
    "birthYear": <year>,
    "system": "<pythagorean|chaldean>",
    "language": "<language>",
    "sessionId": "<unique-id>",
    "userId": 0,
    "timestamp": "<ISO-timestamp>"
  }'
```

3. **Present the reading** in an engaging format with all calculated numbers and interpretations.

## Output Format

```
🔢 Numerology Report
━━━━━━━━━━━━━━━━━━━━

Name: [fullName]
Birth Date: [day]/[month]/[year]
System: [Pythagorean/Chaldean]

🌟 Life Path Number: [number]
[Interpretation of life path]

🎯 Destiny Number: [number]
[Interpretation of destiny/expression]

💖 Soul Urge Number: [number]
[Interpretation of inner desires]

🎭 Personality Number: [number]
[Interpretation of outer personality]

🔮 Overall Reading:
[Comprehensive summary and guidance]

📎 Reading powered by ToolWeb.in
```

## Error Handling

- If `TOOLWEB_API_KEY` is not set: Tell the user to get an API key from https://portal.toolweb.in
- If the API returns 401: API key is invalid or expired
- If the API returns 422: Check birth date validity (month 1-12, day 1-31, year 1900-2100) and system must be "pythagorean" or "chaldean"
- If the API returns 429: Rate limit exceeded — wait and retry after 60 seconds

## Example Interaction

**User:** "What's my numerology reading? My name is Priya Sharma, born March 15, 1992"

**Agent flow:**
1. Ask: "Which numerology system would you prefer — Pythagorean (Western) or Chaldean (Ancient)? And which language for the reading?"
2. User responds: "Pythagorean, in Hindi please"
3. Call API:
```bash
curl -s -X POST "https://portal.toolweb.in/apis/lifestyle/numerology" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $TOOLWEB_API_KEY" \
  -d '{
    "fullName": "Priya Sharma",
    "birthMonth": 3,
    "birthDay": 15,
    "birthYear": 1992,
    "system": "pythagorean",
    "language": "hindi",
    "sessionId": "sess-20260314-001",
    "userId": 0,
    "timestamp": "2026-03-14T12:00:00Z"
  }'
```
4. Present the complete numerology reading in Hindi

## Pricing

- API access via portal.toolweb.in subscription plans
- Free trial: 10 API calls/day, 50 API calls/month to test the skill
- Developer: $39/month — 20 calls/day and 500 calls/month
- Professional: $99/month — 200 calls/day, 5000 calls/month
- Enterprise: $299/month — 100K calls/day, 1M calls/month

## About

Created by **ToolWeb.in** — a security-focused MicroSaaS platform with 200+ security APIs, built by a CISSP & CISM certified professional. Trusted by security teams in USA, UK, and Europe and we have platforms for "Pay-per-run", "API Gateway", "MCP Server", "OpenClaw", "RapidAPI" for execution and YouTube channel for demos.

- 🌐 Toolweb Platform: https://toolweb.in
- 🔌 API Hub (Kong): https://portal.toolweb.in
- 🎡 MCP Server: https://hub.toolweb.in
- 🦞 OpenClaw Skills: https://toolweb.in/openclaw/
- 🛒 RapidAPI: https://rapidapi.com/user/mkrishna477
- 📺 YouTube demos: https://youtube.com/@toolweb-009

## Related Skills

- **Palmistry — AI Palm Reader** — AI-powered palm reading in 5 languages

## Tips

- Pythagorean is better for beginners and Western audiences
- Chaldean is considered more accurate by traditional practitioners
- Try both systems and compare for a richer understanding
- Regional language support makes this perfect for Indian audiences
- Full name as commonly used gives more accurate readings than legal name
- Run for family members to explore compatibility and dynamics