Back to Browse

Namegender MCP Server

Developer ToolsModerate7.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

Gender from names, emails and usernames, with probability, sample size and source on every answer.

About

Gender from names, emails and usernames, with probability, sample size and source on every answer.

Security Report

7.7
Moderate7.7Low Risk

This is a well-designed MCP server with proper authentication, secure credential handling, and appropriate permission scoping. The code is clean, well-tested, and follows security best practices. The server correctly requires an API key via environment variable, uses it only for authorized requests, and implements comprehensive error handling without exposing sensitive details. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

7 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

API key from the namegender.com dashboardRequired

Environment variable: NAMEGENDER_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-anpekesen-namegender": {
      "env": {
        "NAMEGENDER_API_KEY": "your-namegender-api-key-here"
      },
      "args": [
        "-y",
        "namegender-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

NameGender MCP server

Glama quality score

Turns names, email addresses and usernames into a gender — with the evidence next to every answer: the probability, the sample size, the source and the name it matched.

Works in any client that speaks the Model Context Protocol: Claude Desktop, Claude Code, Cursor and others.

namegender-mcp MCP server – quality and maintenance score on Glama

Setup

Get an API key from the namegender.com dashboard. Sign-up needs no card and comes with free credits every day.

Claude Desktop / Claude Code configuration:

{
  "mcpServers": {
    "namegender": {
      "command": "npx",
      "args": ["-y", "namegender-mcp"],
      "env": { "NAMEGENDER_API_KEY": "ng_live_..." }
    }
  }
}

Claude Code from the command line:

claude mcp add namegender -e NAMEGENDER_API_KEY=ng_live_... -- npx -y namegender-mcp

Tools

ToolWhat it does
gender_from_nameGender from a first or full name
gender_from_emailExtracts a name from the local part of an email address
gender_from_usernameExtracts a name from a username or handle
gender_bulkUp to 100 values in one request, with a match-rate summary
name_countriesCountries a name is recorded in — not a claim about origin
account_statusRemaining credits, daily free quota, data version

The gender tools take an optional two-letter country code. The same name can have a different gender from one country to the next; with a code, the answer is weighted by that country's data.

What an answer looks like

Ayşe: female · probability 99% · sample 12,345 · source ssa · country TR

An answer from a source without counts says so:

Kamon: male · probability 95% · no sample (unverified) · source wgnd

The distinction is deliberate. A 95% backed by counted people and a 95% backed by nothing are not the same thing and should not look the same.

Countries are not origin

name_countries keeps two lists apart. Counted birth registrations are published for only seven countries (US, UK, France, Canada, Spain, Ireland, Norway), so the ranked shares compare those seven only. Every other country where the name is recorded appears in a separate, unranked list. Reading the ranking as "where the name comes from" is wrong: Mehmet ranks first in France there, and Turkey is not in the ranking at all.

Errors

Errors do not break the session. The tool returns isError and says what to do — where to top up when credits run out, which variable to check when the key is invalid — and includes the request ID so support can trace it.

Environment variables

VariableDefault
NAMEGENDER_API_KEY(required)
NAMEGENDER_BASE_URLhttps://namegender.com/api/v1

Development

npm install
npm test

MIT licensed.

Releasing

npm version patch   # also updates server.json
git push --follow-tags

The v* tag runs .github/workflows/release.yml: tests, then npm (trusted publishing, no token), then the MCP registry (GitHub OIDC). Re-running the workflow skips whatever is already published.

Reviews

No reviews yet

Be the first to review this server!