sthan-io/mcp-server

Overview

This is a TypeScript SDK, MCP server, and CLI for accessing sthan.io's US address verification, parsing, autocomplete, geocoding, and IP geolocation services. It exposes these capabilities through the Model Context Protocol (MCP) for integration into AI tools and workflows.

Best for

Best for
Developers building MCP‑based tools that need US address verification and geocoding

Use cases

• Validate and standardize US postal addresses in real time.
• Parse raw address strings into structured components (street, city, ZIP).
• Geocode addresses or IP addresses to latitude/longitude coordinates.

How to use

Tools exposed

• sthan_verify_address
• sthan_parse_address
• sthan_autocomplete_address
• sthan_autocomplete_city
• sthan_autocomplete_zipcode
• sthan_geocode
• sthan_reverse_geocode
• sthan_ip_geolocation
• STHAN_API_KEY
• STHAN_API_URL

Tested with

Claude Desktop, Claude Code, Cursor, Windsurf, VS Code

Example client config

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

Notes

This is a TypeScript SDK, MCP server, and CLI for accessing sthan.io’s US address verification, parsing, autocomplete, geocoding, and IP geolocation services. It exposes these capabilities through the Model Context Protocol (MCP) for integration into AI tools and workflows.

0 stars on GitHub. Last updated 2026-06-28. Licensed MIT.

Use cases

• Validate and standardize US postal addresses in real time.
• Parse raw address strings into structured components (street, city, ZIP).
• Geocode addresses or IP addresses to latitude/longitude coordinates.

Pros

• Combines multiple address functions (verification, parse, autocomplete, geocode) in one package.
• Uses the MCP standard, making it easy to plug into MCP‑compatible applications.
• Includes both a library and a CLI for quick testing and scripting.

Cons

• Limited to US addresses only, not suitable for international use.
• Requires a sthan.io API key and an active internet connection.
• Minimal community adoption (0 stars) suggests limited support and documentation.

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.