# GenderAPI.io — MCP server on mcp.ai
> Connect your GenderAPI.io account and use 5 tools for developer tools straight from your AI agent. Connect with your own API key. GenderAPI.io provides an API to determine the gender associated with a given name, email address, or username.

By: mcp.ai · official
Page: https://mcp.ai/genderapi_io

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_genderapi_io?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/genderapi_io/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/genderapi_io/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/genderapi_io/skill.md
Postman collection (v2.1): https://mcp.ai/genderapi_io/postman.json

## Tools
- genderapi_io_gender_api_query_by_first_name(id?: string, ip?: string, name: string, locale?: string, askToAI?: boolean, country?: string, forceToGenderize?: boolean) — Tool to determine gender by querying first name. Use when you need to infer likely gender for a given name with optional localization hints.
- genderapi_io_genderapi_get_stats() — Tool to retrieve account usage statistics from GenderAPI.io. Use when you need to check remaining API credits and expiry.
- genderapi_io_get_gender_from_username(askToAI?: boolean, country?: string, username: string, forceToGenderize?: boolean) — Tool to determine gender from a username or nickname. Use when you have an alias or handle and want to infer gender from that identifier.
- genderapi_io_list_error_codes() — Tool to list all possible error codes returned by Gender API. Use when debugging or validating API responses.
- genderapi_io_query_by_email_address(id?: string, ip?: string, email: string, locale?: string, country?: string) — Tool to determine gender from an email address. Use when you need to infer gender for personalization after obtaining proper consent.

## Example prompts
- "What can I do in GenderAPI.io?"
- "Show me a summary of my GenderAPI.io account"

## Links
Docs: https://mcp.ai/docs/mcps/genderapi_io
Website: https://mcp.ai/mcps/genderapi_io