@sthan/mcp-server 0.1.2 → 0.1.3

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
@@ -19,7 +19,7 @@ function getClient() {
19
19
  }
20
20
  const server = new mcp_js_1.McpServer({
21
21
  name: "sthan",
22
- version: "0.1.2",
22
+ version: "0.1.3",
23
23
  });
24
24
  // --- Tool 1: Verify US Address ---
25
25
  server.tool("sthan_verify_address", "Verify if a US address is real and deliverable. Returns standardized format, ZIP+4, delivery point validation (DPV), and whether it's residential or commercial. Use when someone asks 'is this address real?', 'can mail be delivered here?', or 'verify this address'.", {
package/package.json CHANGED
@@ -1,55 +1,55 @@
1
- {
2
- "name": "@sthan/mcp-server",
3
- "version": "0.1.2",
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.2"
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.3",
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.3"
50
+ },
51
+ "devDependencies": {
52
+ "@types/node": "^25.5.0",
53
+ "typescript": "^6.0.2"
54
+ }
55
+ }