# NamSor — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_namsor?ms=1787293560000`
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. `namsor_classify_diaspora`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/namsor`
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/namsor/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/namsor/classify/diaspora` — 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.
  - body: { names: object[] }
- `POST https://api.mcp.ai/api/namsor/classify/gender` — 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.
  - body: { names: object[] }
- `POST https://api.mcp.ai/api/namsor/classify/origin` — 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.
  - body: { names: object[] }
- `POST https://api.mcp.ai/api/namsor/classify/proper/noun/type` — 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.
  - body: { names: object[] }
- `POST https://api.mcp.ai/api/namsor/classify/residence/country` — 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.
  - body: { names: object[] }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/namsor/parse/names` — 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.
  - body: { names: object[] }

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

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