Log inSubmit server
MCP Server logo

MCP Server

by sthan-io

Verifies, parses, autocompletes, and geocodes US addresses, plus IPv4 and IPv6 geolocation through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "sthan-io-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@sthan/mcp-server"
      ],
      "env": {
        "STHAN_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @sthan/mcp-server

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 28d ago.

Overview

US address and location workflows are exposed by the sthan-io/mcp-server MCP server through eight tools backed by sthan.io APIs. It supports address verification, parsing, autocomplete, forward and reverse geocoding, and IPv4/IPv6 geolocation over stdio. Results include postal validation details, geocoding accuracy and confidence, coordinates, and other location fields. Reach for it when an MCP-compatible client needs structured US address data or IP-based location lookup.

Use cases

  • Verify customer mailing addresses before delivery
  • Parse freeform addresses into structured fields
  • Autocomplete US addresses in data-entry workflows
  • Geocode addresses for map or distance features
  • Look up approximate locations from IP addresses

Key features

  • US address verification with DPV and ZIP+4
  • Freeform address parsing
  • Address, city, and ZIP autocomplete
  • Forward and reverse geocoding
  • IPv4 and IPv6 geolocation
  • MCP stdio transport

Tools8

What MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~236 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @sthan/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads732Package downloads in the last 30 days.
Last commit12d agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed8Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

What sthan-io/mcp-server MCP server does

The sthan-io/mcp-server MCP server connects an MCP-compatible AI client to sthan.io location APIs. Its eight tools cover two related areas: US postal and geographic data, plus IP geolocation.

Address verification checks whether a US address is real and deliverable. The response can include a standardized address, ZIP+4, delivery point validation (DPV), and a residential or commercial classification. Parsing handles freeform US address text and separates fields such as street number, street name, street type, direction, unit, city, state, and ZIP code.

The autocomplete tools return suggestions for partial US addresses, cities, and ZIP codes. Forward geocoding converts a US address into latitude and longitude, with an accuracy classification and confidence score. Reverse geocoding finds the nearest US street address for coordinates and reports the distance in meters. IP geolocation accepts IPv4 or IPv6 and returns country, region, city, coordinates, timezone, and postal code information.

How it works

The server uses the MCP stdio transport. An MCP client launches the npm package locally, and the server calls the sthan.io API using the configured API key. The repository identifies the MCP package as @sthan/mcp-server; its separate @sthan/core package is a TypeScript SDK for direct API use rather than the MCP server itself.

Autocomplete is intended for typeahead-style use and is described as having sub-100ms response times. Geocoding responses include metadata that helps an agent distinguish more precise results, such as rooftop data, from less precise classifications such as approximate results.

Setup and configuration

Install or launch the server with npx -y @sthan/mcp-server in an MCP client configuration. Set STHAN_API_KEY to a key obtained from the sthan.io dashboard. The documentation describes development keys using the sthan_test_* prefix and production keys using sthan_live_*.

STHAN_API_URL is optional and can override the default API base URL, which is https://api.sthan.io. The README provides configurations for Claude Desktop, Claude Code, Cursor, and VS Code, and states that the server works with Windsurf and other MCP-compatible clients.

A local source checkout can also be built with npm workspaces. After building, the repository documents running node packages/mcp-server/dist/index.js with STHAN_API_KEY set.

Tools and capabilities

The sthan-io/mcp-server MCP server exposes these tools:

  • sthan_verify_address validates deliverability and returns postal details.
  • sthan_parse_address extracts components from freeform US address text.
  • sthan_autocomplete_address suggests complete US addresses.
  • sthan_autocomplete_city suggests US cities with state codes.
  • sthan_autocomplete_zipcode suggests US ZIP codes.
  • sthan_geocode converts a US address to coordinates with accuracy and confidence data.
  • sthan_reverse_geocode finds a nearby US street address from coordinates.
  • sthan_ip_geolocation looks up location data for IPv4 or IPv6 addresses.

Limitations and notes

The documented address operations are specifically for the United States. The server depends on the sthan.io APIs for its address, geocoding, and IP location results, so the optional API URL setting is useful only when a different compatible base URL is needed.

The project is released under the MIT license. The repository describes the package as TypeScript-based and publishes it through npm.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

Configure an MCP client to run `npx -y @sthan/mcp-server` and provide the `STHAN_API_KEY` environment variable.

Yes. The README provides a Claude Desktop configuration using the npm package, stdio transport, and `STHAN_API_KEY`.

Verification can return standardized formatting, ZIP+4, DPV, and residential or commercial status. Parsing returns structured address components.

Yes. It reverse-geocodes latitude and longitude to a nearby US address and geolocates IPv4 or IPv6 addresses to location fields.

Yes. `STHAN_API_KEY` is required to run it.

Related MCP servers

All in Location Services All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sthan-io-mcp-server?style=directory)](https://allmcps.com/mcp/sthan-io-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/sthan-io-mcp-server"><img src="https://allmcps.com/api/badge/sthan-io-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>