Gender from names, emails and usernames, with probability, sample size and source on every answer.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON â–¾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for NameGender, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
NameGender MCP server
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.
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:
Claude Code from the command line:
Tools
| Tool | What it does |
|---|---|
gender_from_name | Gender from a first or full name |
gender_from_email | Extracts a name from the local part of an email address |
gender_from_username | Extracts a name from a username or handle |
gender_bulk | Up to 100 values in one request, with a match-rate summary |
name_countries | Countries a name is recorded in — not a claim about origin |
account_status | Remaining 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
An answer from a source without counts says so:
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
| Variable | Default |
|---|---|
NAMEGENDER_API_KEY | (required) |
NAMEGENDER_BASE_URL | https://namegender.com/api/v1 |
Development
MIT licensed.
Releasing
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.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about NameGender
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/namegender-2)HTML Embed
<a href="https://allmcps.com/mcp/namegender-2"><img src="https://allmcps.com/api/badge/namegender-2?style=directory" alt="NameGender on AllMCPs" /></a>