How to Use the Namsor MCP in Claude

Q: How do I configure Namsor with Claude Desktop?

Open your claudedesktopconfig.json file and add the Namsor server under the mcpServers key. Next, provide your API key as an environment variable, restart Claude Desktop, and look for the hammer icon to start running name queries.

Q: What tools are available in this integration?

You get access to six distinct tools: parsefullname, predictcountry, predictdiaspora, predictethnicity, predictgender, and predictorigin. These cover everything from basic name structuring to deep cultural and demographic analytics.

Get instant demographic predictions from names right inside Claude Desktop without leaving your chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Namsor MCP to Claude Desktop

Create your Vinkius account to connect Namsor to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Namsor with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sort messy contact lists inside Claude Desktop

The `parse_full_name` tool cleans up messy contact logs directly in your Claude Desktop chat. You drop a raw list of names into Claude Desktop, and the model instantly splits them into first, last, and middle components. This local setup runs through your Claude Desktop configuration file. It processes raw database dumps in seconds, saving you from writing custom Python scripts just to clean up your CRM data using Namsor.

Target regional campaigns with an MCP Server

The `predict_country` tool checks where your users live based on their names directly inside Claude Desktop. Your Claude Desktop client calls the Namsor API to segment your user base for localized marketing campaigns. By pairing this with `predict_origin` in your Claude Desktop window, your agent identifies cultural roots to customize email copy. You get fast country-level predictions from Namsor without forcing users to fill out annoying location surveys.

Tailor outreach using gender and diaspora insights

The `predict_gender` tool infers user gender, while `predict_diaspora` finds cultural groups outside their home countries right in your Claude Desktop interface. Claude Desktop runs these Namsor checks to help your marketing team build highly targeted demographic cohorts. You can also use `predict_ethnicity` inside Claude Desktop to analyze US-specific demographics for diversity reporting. This gives your Claude Desktop agent the exact Namsor data points needed to build smart, localized messaging strategies on the fly.

Setup guide

Set up Namsor MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Namsor MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Namsor MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under namsor-mcp.

json

{
  "mcpServers": {
    "namsor-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Namsor. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Namsor now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Namsor MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the Namsor server under the `mcpServers` key. Next, provide your API key as an environment variable, restart Claude Desktop, and look for the hammer icon to start running name queries.

Yes, you can connect Namsor to claude.ai by adding a remote MCP URL in your browser settings. This lets you run name parsing and gender predictions directly in your web chats without installing anything locally.

The server passes your API key directly to Namsor, meaning rate limits depend entirely on your subscription plan. If Claude Desktop hits a limit, the API returns a standard rate-limiting error code that your agent will display in the chat.

You get access to six distinct tools: `parse_full_name`, `predict_country`, `predict_diaspora`, `predict_ethnicity`, `predict_gender`, and `predict_origin`. These cover everything from basic name structuring to deep cultural and demographic analytics.

All name strings and demographic predictions are processed through this MCP Server running in Vinkius's zero-trust sandboxed environment. Your raw name inputs are sent securely to Namsor's API and are never stored or logged on our servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript