# Gender API — how to use (mcp.ai)

Connect your Gender API account and use 9 tools for developer tools straight from your AI agent. Connect with your own API key. Gender API determines the gender of a first name, email address, or username.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gender_api?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gender_api_get_country_of_origin`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gender_api`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gender_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gender_api/get/country/of/origin` — Tool to retrieve a name's likely countries of origin. Use after confirming the name identifier.
  - body: { id?: string, email?: string, full_name?: string, first_name?: string }
- `POST https://api.mcp.ai/api/gender_api/get/country/of/origin/v1` — Tool to get the country of origin for a given first name using v1 API. Returns the most likely country where the name is most common.
  - body: { name: string }
- `POST https://api.mcp.ai/api/gender_api/get/statistic` — Tool to retrieve account statistics from Gender-API, including remaining credits and usage details. Use when you need to check your credit balance before performing further gender lookups.
- `POST https://api.mcp.ai/api/gender_api/query/by/email/address` — Determine likely gender from an email address by extracting and analyzing the name portion. Returns male/female/unknown with a confidence score. Optionally filter by country for improved accuracy. Che
  - body: { id?: string, ip?: string, email: string, locale?: string, country?: string }
- `POST https://api.mcp.ai/api/gender_api/query/by/email/address/multiple` — Determine likely gender for multiple email addresses in a single batch request. Returns male/female/unknown with confidence scores for each email. Use for efficient bulk processing. Each result includ
  - body: { emails: object[] }
- `POST https://api.mcp.ai/api/gender_api/query/by/first/name` — Tool to determine the gender of a first name. Use when you need to identify gender based on a given name.
  - body: { id?: string, ip?: string, locale?: string, country?: string, first_name: string }
- `POST https://api.mcp.ai/api/gender_api/query/by/full/name` — Tool to determine gender by splitting a full name. Use when you have an exact full name string and want to infer gender. Slightly less reliable for rare or ambiguous names.
  - body: { id?: string, ip?: string, locale?: string, country?: string, full_name: string }
- `POST https://api.mcp.ai/api/gender_api/query/gender/by/first/name/multiple` — Tool to determine gender for multiple first names in a single batch request. Use when you need to query gender for several names efficiently to save API credits and reduce latency.
  - body: { names: object[] }
- `POST https://api.mcp.ai/api/gender_api/query/gender/by/full/name/multiple` — Tool to batch query gender for multiple full names in a single request. Use when you need to determine gender for multiple names efficiently. Each name can optionally include country, locale, or IP fo
  - body: { names: object[] }

## Example prompts
- "What can I do in Gender API?"
- "Show me a summary of my Gender API account"

## More
- Page: https://mcp.ai/gender_api
- Agent spec (llms.txt): https://mcp.ai/gender_api/llms.txt
- Postman collection: https://mcp.ai/gender_api/postman.json