NUMERANKS

For developers and LLMs

Numeranks MCP

Give your AI assistant a numerology tool. The Numeranks MCP server exposes the name number calculator over the Model Context Protocol, so Claude, Cursor and any MCP client can compute Chaldean name numbers on demand. One URL, nothing to install.

The endpoint

The remote server speaks MCP over HTTP at:

https://www.numeranks.com/api/mcp

Point any MCP client at that URL. The steps below cover the common ones.

Claude Code

Run one command in your terminal:

claude mcp add --transport http numeranks https://www.numeranks.com/api/mcp

Then ask Claude something like “What is the name number for Teena?” and it will call the tool. Remove it later with claude mcp remove numeranks.

Claude Desktop

Claude Desktop launches local (stdio) servers from its config file, so a remote URL is bridged with mcp-remote. Open the config file, add the entry below, then restart Claude Desktop. Node.js must be installed for npx to run.

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "numeranks": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.numeranks.com/api/mcp"]
    }
  }
}

On paid Claude plans you can skip the config file entirely: go to Settings, then Connectors, then Add custom connector, and paste https://www.numeranks.com/api/mcp.

Cursor, Cline, Continue and others

Any client that supports remote MCP servers takes the same URL. In Cursor, add it under Settings then MCP, or drop this into .cursor/mcp.json:

{
  "mcpServers": {
    "numeranks": {
      "url": "https://www.numeranks.com/api/mcp"
    }
  }
}

What you get

The server provides one tool, calculate_name_number. Give it a name and it returns the Chaldean chart: the Destiny or Expression number from every letter, the Soul Urge from the vowels, and the Dream number from the consonants, with the working shown and master numbers kept. For example, asking for the name Teena returns:

Chaldean name numbers for "TEENA"

Destiny / Expression (all letters): 2 from a total of 20, The Diplomat
Soul Urge / Heart's Desire (vowels): 11 (master number, root 2), The Illuminator
Dream / Personality (consonants): 9, The Humanitarian

Letters: T=4 E=5(v) E=5(v) N=5 A=1(v)
Compound number 20 "The Awakening": a call to action for a cause.

The remote endpoint is the simplest path and needs nothing installed. You can also try every calculator directly under free tools.

Frequently asked questions

What is the Numeranks MCP?

It is a Model Context Protocol server that gives any MCP-capable assistant a tool to calculate name numbers. Ask the assistant for a name number and it calls Numeranks and returns the result inline.

Do I need to install anything?

No. The remote endpoint is a URL you add to your client. There is nothing to clone and no Node.js needed on your side.

Is it free?

Yes. The tool is free to use, needs no account, and stores none of the names you send.

Which clients work?

Any client that speaks MCP over HTTP, including Claude Code, Claude Desktop, Cursor, Cline and Continue.

What does the tool return?

For a name it returns the Chaldean Destiny (all letters), Soul Urge (vowels) and Dream (consonants) numbers, the letter-by-letter values, the compound total and its traditional meaning, with master numbers preserved.