# NamSor — MCP server on mcp.ai
> Connect your NamSor account and use 7 tools for artificial intelligence straight from your AI agent. Connect with your own API key. NamSor classifies, parses, and enriches personal names to infer attributes such as gender, country of origin, ethnicity, and cultural context.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_namsor?ms=1787293560000
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/namsor/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/namsor/<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/namsor/skill.md
Postman collection (v2.1): https://mcp.ai/namsor/postman.json

## Tools
- namsor_classify_diaspora(names: object[]) — Infer likely diaspora or ethnicity labels for one or more names within a known country of residence. Accepts 1-100 names and uses 20 NamSor credits per name.
- namsor_classify_gender(names: object[]) — Infer likely gender for one or more first-and-last names. Accepts 1-100 names and costs about 1 NamSor credit per name; results are probabilistic, not verified identity attributes.
- namsor_classify_origin(names: object[]) — Infer likely countries and region of origin for one or more first-and-last names. Accepts 1-100 names and uses 10 NamSor credits per name.
- namsor_classify_proper_noun_type(names: object[]) — Classify one or more proper nouns as likely personal names, brand names, place names, or other NamSor types. Accepts 1-100 values and costs about 1 credit each.
- namsor_classify_residence_country(names: object[]) — Infer likely countries and region of residence for one or more full personal names. Accepts 1-100 names and uses 10 NamSor credits per name; this differs from country of origin.
- namsor_get_account_usage() — Return the connected NamSor account's plan, quota, current billing-period usage, limits, and overage summary without exposing its API key.
- namsor_parse_names(names: object[]) — Parse one or more full personal names into likely first-name and last-name components. Accepts 1-100 names and costs about 1 NamSor credit per name.

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

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