# Numerology Name Calculator MCP

> Numerology Name Calculator uses Pythagorean methods to analyze names. It computes three key numbers—Expression, Soul Urge, and Personality—which reveal a person's core vibrational essence. You can also look up specific number meanings, including interpretations for Master Numbers 11, 22, and 33, giving deep insight into the meaning of their digits.

## Overview
- **Category:** education
- **Price:** Free
- **Tags:** numerology, pythagorean, name-analysis, personality, vibration, astrology

## Description

This MCP connects your agent to Pythagorean numerology principles. Instead of just looking at a name, this tool analyzes the underlying vibrational structure of letters and numbers. It calculates three distinct profile points: Expression (what you project), Soul Urge (your inner desires), and Personality (how others see you). If you run into complex number meanings, like what 11 or 22 really mean, it provides detailed interpretations. Finding this kind of insight used to require specialized knowledge; now, through Vinkius, your agent handles the math and delivers a readable breakdown of the name's deeper meaning.

## Prompt Examples

**Prompt:** 
```
What is the expression number for John Doe?
```

**Response:** 
```
The expression number for John Doe is 7.
```

**Prompt:** 
```
What does the number 11 mean?
```

**Response:** 
```
The number 11 is The Intuitive Master: Highly sensitive, visionary, and inspiring.
```

**Prompt:** 
```
Calculate my soul urge for Jane Smith.
```

**Response:** 
```
The soul urge number for Jane Smith is 5.
```

## Capabilities

### Determine core life expression
Calculates the Expression number, which represents the unique talents and path associated with the name.

### Identify deepest inner desires
Finds the Soul Urge number, revealing the emotional needs and passions that drive you personally.

### Analyze outward persona
Determines the Personality number, showing how others generally perceive you when they meet you.

### Interpret specific numbers
Retrieves detailed definitions and meanings for any resulting digit or Master Number (like 11 or 33).

## Use Cases

### Character Development for Fiction
A writer needs a background profile for a character named 'Alex Rivera.' They ask their agent to run `calculate_expression_number` and `calculate_personality_number`. The resulting numbers help the writer build depth, ensuring Alex's outward appearance matches an internal conflict suggested by the Soul Urge number.

### Gift Giving or Personal Insight
A friend wants to understand their own potential. They ask for a full analysis using `calculate_calibrated_soul_urge_number`. The agent returns the number and detailed meaning, giving the friend actionable insights into their core emotional drivers.

### Understanding Historical Names
A student researching ancient cultures wants to know what a name like 'Cassandra' meant. They use `get_number_interpretation` on the resulting digits, moving past simple definitions to understand the full symbolic weight of the numbers.

## Benefits

- You get three distinct profiles (Expression, Soul Urge, and Personality) without having to learn the math behind Pythagorean numerology. Your agent just runs the calculation and tells you what it means.
- The tool interprets Master Numbers like 11, 22, and 33. You don't just get a number; you get deep context on why that number matters.
- You can compare multiple names side-by-side to see how different profiles stack up against each other for characters or people.
- If you need to know what certain digits mean, the `get_number_interpretation` tool handles it. It’s faster than looking through a reference book.
- `calculate_expression_number` gives you the core identity of the name—what that person is meant to do in life.

## How It Works

The bottom line is that your AI client delivers a full breakdown of the name's vibrational profile in plain English, not just raw data.

1. You provide your agent with a name (or several names) that you want analyzed.
2. The MCP calculates the three separate numbers—Expression, Soul Urge, and Personality—by converting the letters of the name into their corresponding numerical values.
3. Your agent then presents these three core numbers along with their detailed meanings.

## Frequently Asked Questions

**How does the calculation work?**
The tool uses the Pythagorean system, mapping letters to digits 1-9 and preserving Master Numbers 11, 22, and 33. Tools available: `your_tool_name`.

**What is an Expression Number?**
The Expression Number is the total numerical vibration of your full name, calculated by summing all letters.

**Can I use it for any language?**
The calculator is designed for the Latin alphabet (A-Z).

**Can I run `calculate_expression_number` for names containing accents, hyphens, or special characters?**
Yes, the tool handles standard Latin alphabet input and common diacritics. It normalizes complex characters (like accented letters) before calculating the vibrational number.

**How should I use `get_number_interpretation` to get full definitions?**
Simply pass any single digit or Master Number (11, 22, etc.) as input. The tool returns a detailed definition and associated traits for that number.

**Are there rate limits when I call `calculate_calibrated_soul_urge_number`?**
Vinkius manages the usage quota, but all API calls are subject to standard platform rate limiting. Check your client dashboard for specific operational capacity details.

**What format does running `calculate_personality_number` return?**
The result is always returned as a clean integer value within the standard MCP response payload. It's ready to be used immediately by your agent for subsequent steps.

**Do I need any special setup or keys besides connecting my AI client?**
No, you just connect your existing MCP-compatible client to Vinkius and select this tool. The platform handles all necessary authentication; no local installation is required.