@sthan/mcp-server 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +96 -96
  2. package/dist/index.js +1 -1
  3. package/package.json +55 -55
package/README.md CHANGED
@@ -1,96 +1,96 @@
1
- # @sthan/mcp-server
2
-
3
- MCP server for [sthan.io](https://sthan.io) — US address verification, parsing, autocomplete, geocoding, and IP geolocation.
4
-
5
- Works with Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.
6
-
7
- ## Setup
8
-
9
- ### 1. Get an API key
10
-
11
- Sign up at [sthan.io](https://sthan.io) (free tier, no credit card required). Create an API key from your [dashboard](https://sthan.io/dashboard).
12
-
13
- ### 2. Configure your client
14
-
15
- **Claude Code** (`~/.claude/mcp.json` or project `.claude/mcp.json`):
16
-
17
- ```json
18
- {
19
- "mcpServers": {
20
- "sthan": {
21
- "command": "npx",
22
- "args": ["@sthan/mcp-server"],
23
- "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
24
- }
25
- }
26
- }
27
- ```
28
-
29
- **Cursor** (`.cursor/mcp.json`):
30
-
31
- ```json
32
- {
33
- "mcpServers": {
34
- "sthan": {
35
- "command": "npx",
36
- "args": ["@sthan/mcp-server"],
37
- "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
38
- }
39
- }
40
- }
41
- ```
42
-
43
- **VS Code** (`settings.json`):
44
-
45
- ```json
46
- {
47
- "mcp.servers": {
48
- "sthan": {
49
- "command": "npx",
50
- "args": ["@sthan/mcp-server"],
51
- "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
52
- }
53
- }
54
- }
55
- ```
56
-
57
- ## Tools
58
-
59
- | Tool | Description |
60
- |------|-------------|
61
- | `sthan_verify_address` | Verify a US address for deliverability. Returns DPV confirmation, ZIP+4, carrier route. |
62
- | `sthan_parse_address` | Parse freeform address text into structured components (street, city, state, zip, unit). |
63
- | `sthan_autocomplete_address` | Get address suggestions from partial input. Sub-100ms response time. |
64
- | `sthan_autocomplete_city` | Get US city suggestions from partial input. |
65
- | `sthan_autocomplete_zipcode` | Get US ZIP code suggestions from partial input. |
66
- | `sthan_geocode` | Convert a US address to latitude/longitude coordinates. |
67
- | `sthan_reverse_geocode` | Convert coordinates to the nearest US street address. |
68
- | `sthan_ip_geolocation` | Look up geographic location of an IPv4 or IPv6 address. |
69
-
70
- ## Environment variables
71
-
72
- | Variable | Required | Description |
73
- |----------|----------|-------------|
74
- | `STHAN_API_KEY` | Yes | Your sthan.io API key (`sthan_test_*` or `sthan_live_*`) |
75
- | `STHAN_API_URL` | No | Override base URL (default: `https://api.sthan.io`) |
76
-
77
- ## Examples
78
-
79
- Once configured, just ask your AI assistant naturally:
80
-
81
- - "Is 123 Main St, New York, NY 10001 a real address?"
82
- - "Parse this address: apt 2b 500 broadway new york ny"
83
- - "What are the coordinates for the White House?"
84
- - "What address is at 40.7128, -74.0060?"
85
- - "Where is IP 8.8.8.8 located?"
86
-
87
- ## Links
88
-
89
- - [API docs](https://sthan.io/docs)
90
- - [Pricing](https://sthan.io/pricing/united-states)
91
- - [OpenAPI spec](https://api.sthan.io/openapi.json)
92
- - [AI reference](https://api.sthan.io/llms-full.txt)
93
-
94
- ## License
95
-
96
- MIT
1
+ # @sthan/mcp-server
2
+
3
+ MCP server for [sthan.io](https://sthan.io) — US address verification, parsing, autocomplete, geocoding, and IP geolocation.
4
+
5
+ Works with Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.
6
+
7
+ ## Setup
8
+
9
+ ### 1. Get an API key
10
+
11
+ Sign up at [sthan.io](https://sthan.io) (free tier, no credit card required). Create an API key from your [dashboard](https://sthan.io/dashboard).
12
+
13
+ ### 2. Configure your client
14
+
15
+ **Claude Code** (`~/.claude/mcp.json` or project `.claude/mcp.json`):
16
+
17
+ ```json
18
+ {
19
+ "mcpServers": {
20
+ "sthan": {
21
+ "command": "npx",
22
+ "args": ["@sthan/mcp-server"],
23
+ "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
24
+ }
25
+ }
26
+ }
27
+ ```
28
+
29
+ **Cursor** (`.cursor/mcp.json`):
30
+
31
+ ```json
32
+ {
33
+ "mcpServers": {
34
+ "sthan": {
35
+ "command": "npx",
36
+ "args": ["@sthan/mcp-server"],
37
+ "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
43
+ **VS Code** (`settings.json`):
44
+
45
+ ```json
46
+ {
47
+ "mcp.servers": {
48
+ "sthan": {
49
+ "command": "npx",
50
+ "args": ["@sthan/mcp-server"],
51
+ "env": { "STHAN_API_KEY": "sthan_test_your_api_key_here" }
52
+ }
53
+ }
54
+ }
55
+ ```
56
+
57
+ ## Tools
58
+
59
+ | Tool | Description |
60
+ |------|-------------|
61
+ | `sthan_verify_address` | Verify a US address for deliverability. Returns DPV confirmation, ZIP+4, carrier route. |
62
+ | `sthan_parse_address` | Parse freeform address text into structured components (street, city, state, zip, unit). |
63
+ | `sthan_autocomplete_address` | Get address suggestions from partial input. Sub-100ms response time. |
64
+ | `sthan_autocomplete_city` | Get US city suggestions from partial input. |
65
+ | `sthan_autocomplete_zipcode` | Get US ZIP code suggestions from partial input. |
66
+ | `sthan_geocode` | Convert a US address to latitude/longitude coordinates. |
67
+ | `sthan_reverse_geocode` | Convert coordinates to the nearest US street address. |
68
+ | `sthan_ip_geolocation` | Look up geographic location of an IPv4 or IPv6 address. |
69
+
70
+ ## Environment variables
71
+
72
+ | Variable | Required | Description |
73
+ |----------|----------|-------------|
74
+ | `STHAN_API_KEY` | Yes | Your sthan.io API key (`sthan_test_*` or `sthan_live_*`) |
75
+ | `STHAN_API_URL` | No | Override base URL (default: `https://api.sthan.io`) |
76
+
77
+ ## Examples
78
+
79
+ Once configured, just ask your AI assistant naturally:
80
+
81
+ - "Is 123 Main St, New York, NY 10001 a real address?"
82
+ - "Parse this address: apt 2b 500 broadway new york ny"
83
+ - "What are the coordinates for the White House?"
84
+ - "What address is at 40.7128, -74.0060?"
85
+ - "Where is IP 8.8.8.8 located?"
86
+
87
+ ## Links
88
+
89
+ - [API docs](https://sthan.io/docs)
90
+ - [Pricing](https://sthan.io/pricing/united-states)
91
+ - [OpenAPI spec](https://api.sthan.io/openapi.json)
92
+ - [AI reference](https://api.sthan.io/llms-full.txt)
93
+
94
+ ## License
95
+
96
+ MIT
package/dist/index.js CHANGED
@@ -28,7 +28,7 @@ const READ_ONLY_HINTS = {
28
28
  };
29
29
  const server = new mcp_js_1.McpServer({
30
30
  name: "sthan",
31
- version: "0.1.4",
31
+ version: "0.1.6",
32
32
  });
33
33
  // --- Tool 1: Verify US Address ---
34
34
  server.registerTool("sthan_verify_address", {
package/package.json CHANGED
@@ -1,55 +1,55 @@
1
- {
2
- "name": "@sthan/mcp-server",
3
- "version": "0.1.4",
4
- "mcpName": "io.github.sthan-io/mcp-server",
5
- "description": "MCP server for sthan.io — US address verification, parsing, autocomplete, geocoding, and IP geolocation",
6
- "main": "dist/index.js",
7
- "types": "dist/index.d.ts",
8
- "bin": {
9
- "sthan-mcp-server": "dist/index.js"
10
- },
11
- "files": [
12
- "dist",
13
- "README.md"
14
- ],
15
- "scripts": {
16
- "build": "tsc",
17
- "dev": "tsc --watch",
18
- "start": "node dist/index.js"
19
- },
20
- "keywords": [
21
- "mcp",
22
- "mcp-server",
23
- "model-context-protocol",
24
- "address-verification",
25
- "address-parser",
26
- "address-autocomplete",
27
- "geocoding",
28
- "reverse-geocoding",
29
- "ip-geolocation",
30
- "sthan",
31
- "claude",
32
- "cursor",
33
- "vscode",
34
- "ai",
35
- "ai-tools"
36
- ],
37
- "author": "sthan.io",
38
- "license": "MIT",
39
- "homepage": "https://sthan.io",
40
- "repository": {
41
- "type": "git",
42
- "url": "https://github.com/sthan-io/mcp-server"
43
- },
44
- "engines": {
45
- "node": ">=20"
46
- },
47
- "dependencies": {
48
- "@modelcontextprotocol/sdk": "^1.12.1",
49
- "@sthan/core": "0.1.4"
50
- },
51
- "devDependencies": {
52
- "@types/node": "^25.5.0",
53
- "typescript": "^6.0.2"
54
- }
55
- }
1
+ {
2
+ "name": "@sthan/mcp-server",
3
+ "version": "0.1.6",
4
+ "mcpName": "io.github.sthan-io/mcp-server",
5
+ "description": "MCP server for sthan.io — US address verification, parsing, autocomplete, geocoding, and IP geolocation",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "bin": {
9
+ "sthan-mcp-server": "dist/index.js"
10
+ },
11
+ "files": [
12
+ "dist",
13
+ "README.md"
14
+ ],
15
+ "scripts": {
16
+ "build": "tsc",
17
+ "dev": "tsc --watch",
18
+ "start": "node dist/index.js"
19
+ },
20
+ "keywords": [
21
+ "mcp",
22
+ "mcp-server",
23
+ "model-context-protocol",
24
+ "address-verification",
25
+ "address-parser",
26
+ "address-autocomplete",
27
+ "geocoding",
28
+ "reverse-geocoding",
29
+ "ip-geolocation",
30
+ "sthan",
31
+ "claude",
32
+ "cursor",
33
+ "vscode",
34
+ "ai",
35
+ "ai-tools"
36
+ ],
37
+ "author": "sthan.io",
38
+ "license": "MIT",
39
+ "homepage": "https://sthan.io",
40
+ "repository": {
41
+ "type": "git",
42
+ "url": "https://github.com/sthan-io/mcp-server"
43
+ },
44
+ "engines": {
45
+ "node": ">=20"
46
+ },
47
+ "dependencies": {
48
+ "@modelcontextprotocol/sdk": "^1.12.1",
49
+ "@sthan/core": "0.1.6"
50
+ },
51
+ "devDependencies": {
52
+ "@types/node": "^25.5.0",
53
+ "typescript": "^6.0.2"
54
+ }
55
+ }