@sthan/mcp-server

@sthan/mcp-server

MCP server for sthan.io — US address verification, parsing, autocomplete, geocoding, and IP geolocation.

Works with Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.

Setup

1. Get an API key

Sign up at sthan.io (free tier, no credit card required). Create an API key from your dashboard.

2. Configure your client

Claude Code (~/.claude/mcp.json or project .claude/mcp.json):

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

Cursor (.cursor/mcp.json):

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

VS Code (settings.json):

{
  "mcp.servers": {
    "sthan": {
      "command": "npx",
      "args": ["@sthan/mcp-server"],
      "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
    }
  }
}

Tools

Tool	Description
sthan_verify_address	Verify a US address for deliverability. Returns DPV confirmation, ZIP+4, carrier route.
sthan_parse_address	Parse freeform address text into structured components (street, city, state, zip, unit).
sthan_autocomplete_address	Get address suggestions from partial input. Sub-100ms response time.
sthan_autocomplete_city	Get US city suggestions from partial input.
sthan_autocomplete_zipcode	Get US ZIP code suggestions from partial input.
sthan_geocode	Convert a US address to latitude/longitude coordinates.
sthan_reverse_geocode	Convert coordinates to the nearest US street address.
sthan_ip_geolocation	Look up geographic location of an IPv4 or IPv6 address.

Environment variables

Variable	Required	Description
STHAN_API_KEY	Yes	Your sthan.io API key (sthan_test_* or sthan_live_*)
STHAN_API_URL	No	Override base URL (default: https://api.sthan.io)

Examples

Once configured, just ask your AI assistant naturally:

• "Is 123 Main St, New York, NY 10001 a real address?"
• "Parse this address: apt 2b 500 broadway new york ny"
• "What are the coordinates for the White House?"
• "What address is at 40.7128, -74.0060?"
• "Where is IP 8.8.8.8 located?"

Links

• API docs
• Pricing
• OpenAPI spec
• AI reference

License

MIT