Mcp Server
Connects Claude to sthan.io's US postal APIs. You get eight tools: verify addresses against USPS data with DPV and ZIP+4, parse freeform text into structured components, autocomplete addresses/cities/ZIPs with sub-100ms response times, forward and reverse geocoding with accuracy scores, and IPv4/IPv6 geolocation. The verify endpoint is the standout here, returning delivery point validation and residential/commercial flags from real postal records instead of guessing. Runs via stdio, needs a free API key from sthan.io (no credit card), and works with Claude Desktop, Cursor, VS Code, or any MCP client. Useful when you're building workflows that need to validate shipping addresses, enrich location data, or let Claude handle geospatial queries without hallucinating coordinates.
- tools
- 8
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Oct 16, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
sthan_verify_addressVerify a US address is real and deliverable. Returns standardized format, ZIP+4, DPV, residential/commercial.
Verify a US address is real and deliverable. Returns standardized format, ZIP+4, DPV, residential/commercial.
No parameter schema in public metadata yet.
sthan_parse_addressParse freeform US address text into structured components (street number, name, type, direction, unit, city, state, zip).
Parse freeform US address text into structured components (street number, name, type, direction, unit, city, state, zip).
No parameter schema in public metadata yet.
sthan_autocomplete_addressSuggest complete US addresses from partial input. Sub-100ms.
Suggest complete US addresses from partial input. Sub-100ms.
No parameter schema in public metadata yet.
sthan_autocomplete_citySuggest US cities from partial input, with state code.
Suggest US cities from partial input, with state code.
No parameter schema in public metadata yet.
sthan_autocomplete_zipcodeSuggest US ZIP codes from partial input.
Suggest US ZIP codes from partial input.
No parameter schema in public metadata yet.
sthan_geocodeUS address → latitude/longitude with accuracy + confidence, county, ZIP+4 and time zone.
US address → latitude/longitude with accuracy + confidence, county, ZIP+4 and time zone.
No parameter schema in public metadata yet.
sthan_reverse_geocodeLatitude/longitude → nearest US street address with distance in meters, county, ZIP+4 and time zone; limit (up to 10) also lists nearby addresses.
Latitude/longitude → nearest US street address with distance in meters, county, ZIP+4 and time zone; limit (up to 10) also lists nearby addresses.
No parameter schema in public metadata yet.
sthan_ip_geolocationIPv4 or IPv6 → location (country to postal code, local time, flag, currency), the network behind it (ASN, ISP, proxy/hosting flags) and a confidence score.
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.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
STHAN_API_KEY*secretYour sthan.io API key (get one free at https://sthan.io/dashboard)
Readme
Sthan MCP Server
MCP server for 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
Details
- Repository
- github.com/sthan-io/mcp-server
- Package
@sthan/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active