Nationalize
live DemographicsPredict the nationality of a first name with ranked country probabilities, including batch lookups via nationalize.io
2 tools
0ms auth
free tier 50 calls/day
Tools
predict_nationality
required: name Predict the most likely nationalities for a given first name, ranked by probability. Returns up to 5 country codes with probability scores.
Parameters
Name Type Description
name req string First name to predict nationality for. Try it
Response
batch_predict
required: names Predict nationalities for multiple first names in a single request (up to 10 names). Returns ranked nationality probabilities for each name.
Parameters
Name Type Description
names req array Array of first names to predict nationality for (maximum 10). Try it
Response
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");Related packs
Other Pipeworx packs in the same categories (Demographics):