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 the most likely nationalities for a given first name, ranked by probability. Returns up to 5 country codes with probability scores.

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

Predict nationalities for multiple first names in a single request (up to 10 names). Returns ranked nationality probabilities for each name.

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");