---
title: "NamSor integration for LuumenAI"
url: "https://www.luumen.ai/integrations/namsor/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# NamSor integration for LuumenAI

Read name classifications and account usage from NamSor in your terminal

## What LuumenAI can do with NamSor

LuumenAI connects to NamSor with an API token and exposes 7 tools (7 read-only). Every tool is read-only, so it can answer questions from NamSor but cannot change anything in it.

## Key facts

- Authentication: API token
- Tools available: 7 tools (7 read-only)
- Plan: available on all plans
- Category: AI & automation

## About NamSor with LuumenAI

Ask about a name and get an answer back in the terminal. NAMSOR_PARSE_NAMES splits full names into first and last parts. NAMSOR_CLASSIFY_GENDER, NAMSOR_CLASSIFY_ORIGIN, NAMSOR_CLASSIFY_RESIDENCE_COUNTRY, and NAMSOR_CLASSIFY_DIASPORA infer likely attributes, and NAMSOR_CLASSIFY_PROPER_NOUN_TYPE sorts personal names from brands and places. NAMSOR_GET_ACCOUNT_USAGE reports plan, quota, and overage without exposing the API key. All seven tools are read-only, so they answer immediately.

## Example tools

Read-only (7 in total):

- `NAMSOR_CLASSIFY_DIASPORA` — Infer likely diaspora or ethnicity labels for one or more names within a known country of residence.
- `NAMSOR_CLASSIFY_GENDER` — Infer likely gender for one or more first-and-last names.
- `NAMSOR_CLASSIFY_ORIGIN` — Infer likely countries and region of origin for one or more first-and-last names.
- `NAMSOR_CLASSIFY_PROPER_NOUN_TYPE` — Classify one or more proper nouns as likely personal names, brand names, place names, or other NamSor types.
- `NAMSOR_CLASSIFY_RESIDENCE_COUNTRY` — Infer likely countries and region of residence for one or more full personal names.
- `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` — Parse one or more full personal names into likely first-name and last-name components.

## Frequently asked questions

### How does LuumenAI connect to NamSor?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in NamSor on its own?

No. Every one of the 7 tools is read-only, so LuumenAI can answer questions from NamSor but cannot change anything in it.

### Is there an audit trail?

Every call to NamSor is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/namsor/