| 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":"[Truncated]","bins":"[Truncated]"},"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
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.incurl 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
-
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"
-
Call the API:
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>"
}'
- 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:
- Ask: "Which numerology system would you prefer — Pythagorean (Western) or Chaldean (Ancient)? And which language for the reading?"
- User responds: "Pythagorean, in Hindi please"
- Call API:
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"
}'
- 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.
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
