Nationalize

liveDemographics

Predict the nationality of a first name with ranked country probabilities, including batch lookups via nationalize.io

2tools
0msauth
free tier50 calls/day

Tools

predict_nationalityrequired: name

Predict likely nationalities from a first name. Returns up to 5 country codes ranked by probability (0.0–1.0). Use when inferring someone's origin from their given name.

Parameters
NameTypeDescription
namereqstringFirst name to predict nationality for.
▶Try it
batch_predictrequired: names

Predict nationalities for multiple first names at once (up to 10). Returns country codes with probability scores for each name. Use to process name lists efficiently.

Parameters
NameTypeDescription
namesreqarrayArray of first names to predict nationality for (maximum 10).
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/nationalize/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/nationalize/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"predict_nationality","arguments":{"name": "test"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("predict_nationality", {"name":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("predict the nationality of a first name with ranked country probabilities, including batch lookups via nationalize");