# NameGender

> NameGender is a freemium MCP server for analytics and data. Name tools for assistants: gender, salutations, name checks and age, with evidence. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://namegender.com/docs
- **Repository:** https://github.com/anpekesen/namegender-mcp
- **MCP Registry name:** io.github.anpekesen/namegender
- **Categories:** analytics and data, sales and CRM
- **Listing updated:** 2026-11-16

## About

NameGender wraps its REST API in nine tools that an assistant can call over a list of names. Gender can be inferred from a first or full name, from the name inside an email address (role addresses such as info@ return unknown) or from a username, and a bulk tool takes up to 100 values with a match-rate summary. Every answer carries the evidence, including sample size, probability, confidence and source.

The other tools are more specific than a plain gender guess. One returns the countries where a name is recorded, without claiming origin. Another writes the opening line of a letter in the letter's language, falling back to a neutral form when gender is uncertain. A name check says whether a name typed into a form looks real and explains why, but never calls a name fake, and an age tool gives median age and ranges for first names in the US, France and Norway.

Optional country, locale or IP hints sharpen names whose gender differs by region, such as Andrea. By default it returns null rather than a near 50/50 answer. It is an npm stdio package that needs an API key, and each lookup uses account credits. Free accounts get 100 credits a day.

## Features

- **Gender from name:** Classify a first or full name, with titles and surnames stripped.
- **Email and username parsing:** Read the name from an address or handle.
- **Bulk lookups:** Up to 100 values with a match-rate summary.
- **Salutations:** Letter openings in the right language, neutral when unsure.
- **Name checks:** Judge whether a form entry looks real, with reasons.
- **Age estimates:** Median age and ranges by first name for the US, France and Norway.
- **Country context:** Use country, locale or IP to disambiguate regional names.

## Good for

- Personalise a mailing list greeting
- Clean a spreadsheet of names with a match-rate report
- Flag unlikely names on a signup form
- Estimate gender balance of a customer list

## Install

### Claude Code (Terminal)

```sh
claude mcp add namegender --env NAMEGENDER_API_KEY='<NAMEGENDER_API_KEY>' -- npx -y namegender-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "namegender": {
      "command": "npx",
      "args": [
        "-y",
        "namegender-mcp"
      ],
      "env": {
        "NAMEGENDER_API_KEY": "<NAMEGENDER_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "namegender": {
      "command": "npx",
      "args": [
        "-y",
        "namegender-mcp"
      ],
      "env": {
        "NAMEGENDER_API_KEY": "<NAMEGENDER_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "namegender": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "namegender-mcp"
      ],
      "env": {
        "NAMEGENDER_API_KEY": "<NAMEGENDER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "namegender": {
      "command": "npx",
      "args": [
        "-y",
        "namegender-mcp"
      ],
      "env": {
        "NAMEGENDER_API_KEY": "<NAMEGENDER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "namegender": {
      "command": "npx",
      "args": [
        "-y",
        "namegender-mcp"
      ],
      "env": {
        "NAMEGENDER_API_KEY": "<NAMEGENDER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `gender_from_name`: Gender from a first or full name
- `gender_from_email`: Gender from the name in an email address
- `gender_from_username`: Gender from a username or handle
- `gender_bulk`: Up to 100 values in one request
- `name_countries`: Countries where a name is recorded
- `salutation`: Opening line of a letter in the right language
- `name_check`: Whether a typed name looks real, with reasons
- `age_from_name`: Median age and ranges for a first name
- `account_status`: Remaining credits and free quota

## FAQ

### Is there a free tier?

Yes, 100 credits every day with full API access.

### What does a lookup return?

Gender plus probability, sample size, confidence and source, so you can judge the answer.

### Does it guess when unsure?

By default it returns null instead of a near 50/50 answer, unless best_guess is set.

### What do I need to run it?

An API key from the namegender.com dashboard and the npx package.

### Is NameGender free?

NameGender has a free plan, with paid plans for more usage or features.

### How do I add NameGender to Claude Code?

Run this command in your terminal: claude mcp add namegender --env NAMEGENDER_API_KEY='<NAMEGENDER_API_KEY>' -- npx -y namegender-mcp

### What are the best alternatives to NameGender?

The closest alternatives to NameGender are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/namegender
