Sthan Io MCP

Name: Sthan Io MCP
Author: sthan-io

by sthan-ioversion 0.1.11i★ –iRuns on your computer

Registry nameio.github.sthan-io/mcp-server

Install

Overview

Description from the maker (original English)

US address verification, parsing, autocomplete, geocoding, and IP geolocation APIs.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: STHAN_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: STHAN_API_KEY

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "sthan-io": {
      "command": "npx",
      "args": [
        "-y",
        "@sthan/mcp-server"
      ],
      "env": {
        "STHAN_API_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add sthan-io --env STHAN_API_KEY=your-value -- npx -y @sthan/mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "sthan-io": {
      "command": "npx",
      "args": [
        "-y",
        "@sthan/mcp-server"
      ],
      "env": {
        "STHAN_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "sthan-io": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sthan/mcp-server"
      ],
      "env": {
        "STHAN_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

STHAN_API_KEY secret required env
Your sthan.io API key (get one free at https://sthan.io/dashboard)

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sthan-io, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32673 servers in this category
Published to the registry more recently than 64% of the other 32673 servers in this category
Basic checks equal to or better than 100% of the other 32673 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Sthan Io MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: STHAN_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.11) reached the registry 21 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Systemdox

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

Systemdox

by puglieseweb

Your architecture in your agents' context: checks, specs, ADRs and docs over MCP, at write time.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Sthan MCP Server

MCP server for [sthan.io](https://sthan.io) — give your AI assistant the ability to verify, parse, autocomplete, and geocode US addresses, and look up IP geolocation. Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.

8 tools · TypeScript · stdio transport · Free tier, no credit card required.

Why use it

Real US postal data — addresses are verified against authoritative postal records, not heuristics. Returns delivery point validation (DPV), ZIP+4, residential/commercial flag.
Sub-100ms autocomplete — typeahead-grade response times for address, city, and ZIP suggestions.
Strong geocoding — forward geocoding returns accuracy classification (rooftop / interpolated / centroid / approximate) plus a confidence score, so your AI knows when to trust the result.
IPv4 + IPv6 geolocation — country, region, city, coordinates, postal code, timezone with current local time, flag, currency, calling code, network (ASN, ISP, organisation), mobile/proxy/hosting flags, reverse DNS and a confidence score.
Free tier with no credit card — get a key in under a minute at sthan.io/dashboard.

Tools

Tool	What it does
`sthan_verify_address`	Verify a US address is real and deliverable. Returns standardized format, ZIP+4, DPV, residential/commercial.
`sthan_parse_address`	Parse freeform US address text into structured components (street number, name, type, direction, unit, city, state, zip).
`sthan_autocomplete_address`	Suggest complete US addresses from partial input. Sub-100ms.
`sthan_autocomplete_city`	Suggest US cities from partial input, with state code.
`sthan_autocomplete_zipcode`	Suggest US ZIP codes from partial input.
`sthan_geocode`	US address → latitude/longitude with accuracy + confidence, county, ZIP+4 and time zone.
`sthan_reverse_geocode`	Latitude/longitude → nearest US street address with distance in meters, county, ZIP+4 and time zone; `limit` (up to 10) also lists nearby addresses.
`sthan_ip_geolocation`	IPv4 or IPv6 → location (country to postal code, local time, flag, currency), the network behind it (ASN, ISP, proxy/hosting flags) and a confidence score.

Quick start

1. Get a free API key

2. One-click install

Claude Desktop: download sthan.mcpb and double-click it. Claude asks for your API key and keeps it in your system keychain. Nothing else to install.
VS Code: click the button. VS Code asks for your API key and stores it securely.
Cursor: click the button, then replace your_key_here with your key in Cursor Settings > MCP.
Claude Code: claude mcp add sthan -e STHAN_API_KEY=your_key_here -- npx -y @sthan/mcp-server (details below).

3. Or set it up manually

Replace your_key_here with your key. Every setup below downloads the latest @sthan/mcp-server from npm and calls the live API at https://api.sthan.io.

Claude Code (terminal):

claude mcp add sthan -e STHAN_API_KEY=your_key_here -- npx -y @sthan/mcp-server

On native Windows, wrap npx with cmd /c:

claude mcp add sthan -e STHAN_API_KEY=your_key_here -- cmd /c npx -y @sthan/mcp-server

Add --scope user to use it in every project. Start claude and type /mcp to confirm sthan is connected.

Claude Desktop: edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop:

"mcpServers": { "sthan": { "command": "npx", "args": ["-y", "@sthan/mcp-server"], "env": { "STHAN_API_KEY": "your_key_here" } } } }

Cursor: the same JSON in ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

Windsurf: the same JSON in ~/.codeium/windsurf/mcp_config.json.

VS Code: create .vscode/mcp.json. VS Code asks for the key once and stores it securely:

"inputs": [ { "type": "promptString", "id": "sthan-api-key", "description": "sthan.io API key", "password": true } ], "servers": { "sthan": { "type": "stdio", "command": "npx", "args": ["-y", "@sthan/mcp-server"], "env": { "STHAN_API_KEY": "${input:sthan-api-key}" } } } }

Try it without an AI client (opens the official MCP Inspector in your browser):

npx @modelcontextprotocol/inspector -e STHAN_API_KEY=your_key_here npx -y @sthan/mcp-server

Click Connect, then Tools > List Tools, pick a tool, and run it.

Troubleshooting

Keep the -y in npx -y. Without it, npx waits for an "OK to install?" answer that an AI client cannot give, and the server never starts.
On Windows, run the claude mcp add ... cmd /c ... command from PowerShell or Command Prompt. Git Bash rewrites /c to C:/, which saves a broken command that times out (fix: prefix it with MSYS_NO_PATHCONV=1).
On Windows, if a client reports spawn npx ENOENT, use "command": "cmd" with "args": ["/c", "npx", "-y", "@sthan/mcp-server"].
Address verification and parsing can take up to about 2 minutes when a live postal lookup is needed. If your client gives up sooner, raise its tool timeout (Claude Code: set MCP_TOOL_TIMEOUT=150000 before starting claude; MCP Inspector: raise Request Timeout in its Configuration panel).

Example prompts

Once configured, just ask your AI assistant naturally:

*"Is 123 Main St, New York, NY 10001 a real, deliverable address?"*
*"Parse this address: apt 2b 500 broadway new york ny"*
*"What are the coordinates of 1600 Pennsylvania Ave, Washington DC?"*
*"What's the nearest address to 40.7128, -74.0060?"*
*"Where is IP 8.8.8.8 located?"*
*"Suggest US cities starting with 'San Fr'."*

Environment variables

Variable	Required	Description
`STHAN_API_KEY`	Yes	Your sthan.io API key (`sthan_test_` for development, `sthan_live_` for production)
`STHAN_API_URL`	No	Override base URL (default: `https://api.sthan.io`)

Response times

Most calls return in 1 to 3 seconds. Address verification and parsing can take longer (up to about 2 minutes) when an address cannot be matched from sthan.io's own data and needs a live postal lookup, so the server waits up to 150 seconds for those two tools. If your MCP client stops waiting sooner, raise its tool timeout (for example, in Claude Code set MCP_TOOL_TIMEOUT=150000).

Packages

This monorepo publishes two packages:

Package	npm	Purpose
`@sthan/mcp-server`		The MCP server itself — the binary that your client launches
`@sthan/core`		TypeScript SDK for direct programmatic use of sthan.io APIs

Development

git clone https://github.com/sthan-io/mcp-server.git

cd mcp-server npm install npm run build --workspaces

Then run the server with STHAN_API_KEY=sthan_test_... node packages/mcp-server/dist/index.js.

License

MIT — see LICENSE.

Sthan Io MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Systemdox

README from the maker

Sthan MCP Server

Why use it

Tools

Quick start

1. Get a free API key

2. One-click install

3. Or set it up manually

Example prompts

Environment variables

Response times

Packages

Development

Links

License