otherapi_key

NamSor

NamSor classifies, parses, and enriches personal names to infer attributes such as gender, country of origin, ethnicity, and cultural context.

Verdict

NamSor infers demographic and geographic attributes from personal names using probabilistic models. An @mention lets your team parse names into components, classify gender, estimate country of origin or residence, identify diaspora communities, and distinguish personal names from brands or places. Marketing and research teams use it to segment contact lists, localize outreach, and audit data quality. Each inference consumes NamSor credits from your account quota; batch operations process up to 100 names at once. Results are statistical estimates, not verified identity data, so treat them as signals rather than facts.

Common use cases

  • Segment email lists by inferred region
  • Localize sales outreach with name origin data
  • Parse messy contact names into structured fields
  • Audit CRM records for likely duplicates
  • Identify diaspora communities in customer base

Integration

Vendor
NamSor
Category
other
Auth
API_KEY
Tools
7
Composio slug
namsor

Tools

  • Classify Name 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.

  • Classify Name 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.

  • Classify Name 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.

  • 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.

  • 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.

  • Get Account Usage

    Return the connected NamSor account's plan, quota, current billing-period usage, limits, and overage summary without exposing its API key.

  • Parse Personal 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.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the MCP integrations panel. 2. Select 'Add MCP' and choose NamSor from the catalog. 3. You'll be prompted to paste your NamSor API key, which you generate in the NamSor dashboard under API Keys. 4. Grant the integration read access to your account usage and write access to classification endpoints. 5. Click 'Connect' and wait for Switchy to validate the key against NamSor's API. 6. Open any Project, type '@NamSor get account usage' in a message, and confirm you see your current credit balance and plan details. 7. Test a classification by typing '@NamSor classify name gender' followed by a sample name; the response should include a probability score and inferred gender label.

What teammates see: by default, memories from NamSor are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Parse Contact Names

@NamSor parse the following names into first and last components: Maria Garcia Lopez, John O'Brien, Wei Zhang, Fatima Al-Mansoori.

Infer Campaign Geography

@NamSor classify the likely country of origin for these names: Aarav Patel, Yuki Tanaka, Lars Svensson, Chioma Okafor, Sofia Rossi.

Segment by Diaspora

@NamSor classify diaspora or ethnicity for these names, assuming they reside in the United States: Nguyen Thi Lan, Rajesh Kumar, Olga Petrov, Carlos Hernandez.

Distinguish Names from Brands

@NamSor classify whether each of these is a personal name, brand, or place: Tesla, Angela Merkel, Microsoft, Paris, Sundar Pichai.

Check Credit Balance

@NamSor get my account usage summary, including current billing period consumption and remaining quota.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@NamSor parse these 15 customer names from our signup CSV into first and last name fields so I can personalize our welcome emails.

Output

Parsed 15 names into structured first-name and last-name components. For example, 'Maria Garcia Lopez' became firstName: 'Maria', lastName: 'Garcia Lopez' with 94% confidence. Two entries ('Dr. Chen', 'J.Smith') returned lower confidence scores due to abbreviated formats. All results are now available as structured data you can map into your email template merge fields.

Notes

Parsing costs ~1 NamSor credit per name and works best with full names in Latin script. The tool infers structure probabilistically—review low-confidence results before using them in customer-facing communications. Batch up to 100 names per call to stay within rate limits.

Prompt

@NamSor classify the gender for this list of 40 conference attendee names so we can generate pronoun badges without asking each person individually.

Output

Classified 40 names with probabilistic gender inferences. Results show 28 names with high confidence (>85%), 9 with moderate confidence (60-85%), and 3 ambiguous cases flagged for manual review. For instance, 'Alex Kim' returned 52% probability male, 48% female—too close to automate. Each classification consumed approximately 1 credit; total usage was 42 credits including API overhead.

Notes

Gender classification is probabilistic and culturally dependent, not a verified identity attribute. Never use these inferences to make assumptions about individuals—this example illustrates a workflow that should always include an opt-in step where attendees confirm their own pronouns. The MCP cannot replace respectful direct communication.

Prompt

@NamSor check our account usage and then infer the likely countries of origin for these 50 supplier contact names to help us plan regional outreach campaigns.

Output

Account status: 12,400 credits remaining in your monthly quota, 3,200 used this billing period. Classified 50 names for country of origin using 500 credits (10 per name). Results show 22 names likely originating from India, 14 from China, 8 from Germany, and 6 distributed across other regions. Each result includes a region label (e.g., 'South Asia', 'East Asia') and a confidence score; 41 names exceeded 75% confidence.

Notes

Origin inference uses 10 credits per name—monitor your quota with Get Account Usage before large batches. The tool returns likely cultural or geographic origin based on name patterns, not citizenship or current residence. Confidence scores help you prioritize which segments justify localized outreach; low-confidence results may need manual research.

Use-case deep-dives

Localization research for SaaS signup

When name-origin inference beats manual user surveys

A 6-person growth team at a B2B SaaS company sees 400 trial signups a month but can't afford a localization agency. They pipe signup names through NamSor's Classify Name Origin tool in a weekly batch to spot geographic clusters—if 30% of new users come from LATAM, that's a signal to prioritize Spanish docs before the next quarter. The gender and diaspora classifiers stay off; the team only needs country-level patterns, not individual demographic guesses. This works when you're aggregating cohorts of 50+ names and treating the output as a planning heuristic, not a per-user personalization layer. If you need real-time localization or sub-10-name samples, the probabilistic model will mislead you. For teams shipping their first international feature and working from a spreadsheet of names, this MCP turns guesswork into a $20/month data habit.

CRM deduplication at mid-market scale

Parsing 10k messy contact records without a data engineer

A 12-person sales ops team inherits a CRM with 10,000 contacts where half the records jam first and last names into a single field. They batch the full-name strings through NamSor's Parse Personal Names tool, get structured first/last pairs back, then run a fuzzy-match deduplication script in their BI tool. The 1-credit-per-name cost is trivial compared to hiring a contractor to hand-clean the data. The proper-noun classifier helps flag company names that snuck into the contact list. This scenario wins when your CRM hygiene problem is a one-time or quarterly cleanup, not a real-time data pipeline. If you're syncing thousands of new records daily, you need a dedicated ETL tool with name-parsing built in. For teams stuck in spreadsheet hell and facing a board meeting in two weeks, this MCP is the fastest path to a usable contact list.

Academic research on author diversity

When probabilistic ethnicity labels are good enough for aggregate stats

A 3-person research team at a university is analyzing 2,000 academic paper bylines to report on author diversity trends in a grant proposal. They feed author names through the Classify Name Diaspora tool, bin the results by region, and publish aggregate percentages—never attributing ethnicity to individuals. The 20-credit-per-name cost fits a $200 research budget. The team documents the probabilistic nature of the inference in their methodology footnote and avoids using the data for any individual-level decision. This works when you're publishing cohort statistics and your IRB has cleared the approach. If you're making hiring decisions, awarding grants, or personalizing outreach based on inferred demographics, this tool is the wrong ethical choice. For academic teams who need a rough demographic lens on large name datasets and understand the model's limits, this MCP delivers a defensible first pass.

Frequently asked

What does the NamSor MCP do in Switchy?

It lets your team infer gender, ethnicity, origin country, and residence from personal names using NamSor's API. You can batch up to 100 names per request across seven tools—parsing names into components, classifying proper nouns, and estimating diaspora labels. Each operation consumes NamSor credits from your account; gender classification costs roughly 1 credit per name, while origin and diaspora queries use 10–20 credits each.

Do I need a paid NamSor account to use this MCP?

Yes. You connect via an API key, and every classification draws from your NamSor credit balance. The Get Account Usage tool shows your quota and billing-period consumption without exposing the key. If you exhaust your plan's included credits, NamSor charges overage fees according to your subscription tier. Free-tier keys will hit limits quickly on batch requests.

Can the MCP verify someone's actual gender or ethnicity?

No. NamSor returns probabilistic labels based on name patterns in its training data—it does not access identity documents or self-reported demographics. The Classify Name Gender and Classify Name Diaspora tools produce statistical guesses, not verified attributes. Use the results for aggregate research or segmentation, never for individual identity decisions or compliance workflows that require verified data.

How is this different from calling NamSor's REST API directly?

The MCP wraps NamSor's batch endpoints so your AI agents can classify names mid-conversation without writing HTTP clients. You skip manual JSON construction and credit accounting—Switchy passes arrays of names to the tool, and the response includes scores and country codes. If your team already has working API scripts, those will be faster; the MCP trades raw speed for conversational convenience.

Who on the team should connect the NamSor API key?

Whoever owns your NamSor subscription and can generate API keys. That person's credit balance funds every classification the team runs through Switchy. If multiple people need access, create a shared service account in NamSor and rotate the key in Switchy's integration settings. Watch usage via the Get Account Usage tool to avoid surprise overage charges mid-month.

More other MCPs

See all other MCPs →

Data last verified 62 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.