@sthan/mcp-server 0.1.1 → 0.1.3

package/dist/index.js

@@ -5,20 +5,21 @@ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const core_1 = require("@sthan/core");
 const zod_1 = require("zod");
-const apiKey = process.env.STHAN_API_KEY;
-if (!apiKey) {
-    console.error("Error: STHAN_API_KEY environment variable is required.\n" +
-        "Get your API key at https://sthan.io/dashboard\n" +
-        "Set it: export STHAN_API_KEY=sthan_test_your_key_here");
-    process.exit(1);
+const MISSING_KEY_MESSAGE = "STHAN_API_KEY environment variable is not set. " +
+    "Get a free key at https://sthan.io/dashboard, then set STHAN_API_KEY in your MCP client config.";
+function getClient() {
+    const apiKey = process.env.STHAN_API_KEY;
+    if (!apiKey) {
+        throw new Error(MISSING_KEY_MESSAGE);
+    }
+    return new core_1.SthanClient({
+        apiKey,
+        baseUrl: process.env.STHAN_API_URL,
+    });
 }
-const client = new core_1.SthanClient({
-    apiKey,
-    baseUrl: process.env.STHAN_API_URL,
-});
 const server = new mcp_js_1.McpServer({
     name: "sthan",
-    version: "0.1.0",
+    version: "0.1.3",
 });
 // --- Tool 1: Verify US Address ---
 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'.", {
@@ -27,7 +28,7 @@ server.tool("sthan_verify_address", "Verify if a US address is real and delivera
         .describe("Full or partial US address in any format. Examples: '123 Main St, New York, NY 10001', '123 main st nyc', '1600 Pennsylvania Ave Washington DC'"),
 }, async ({ address }) => {
     try {
-        const response = await client.verifyAddress(address);
+        const response = await getClient().verifyAddress(address);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -43,7 +44,7 @@ server.tool("sthan_parse_address", "Parse a freeform US address string into stru
         .describe("Raw address text to parse. Freeform input, abbreviations OK. Example: 'apt 2b 500 broadway new york ny'"),
 }, async ({ address }) => {
     try {
-        const response = await client.parseAddress(address);
+        const response = await getClient().parseAddress(address);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -59,7 +60,7 @@ server.tool("sthan_autocomplete_address", "Get address suggestions from partial
         .describe("Partial address text (3+ characters recommended). Example: '123 Main'"),
 }, async ({ text }) => {
     try {
-        const response = await client.autocompleteAddress(text);
+        const response = await getClient().autocompleteAddress(text);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -80,7 +81,7 @@ server.tool("sthan_autocomplete_city", "Get US city name suggestions from partia
         .describe("0 = City, StateCode (e.g. 'San Francisco, CA'). 1 = City, State (e.g. 'San Francisco, California')"),
 }, async ({ text, display_type }) => {
     try {
-        const response = await client.autocompleteCity(text, display_type);
+        const response = await getClient().autocompleteCity(text, display_type);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -101,7 +102,7 @@ server.tool("sthan_autocomplete_zipcode", "Get US ZIP code suggestions from part
         .describe("0 = Zip,StateCode. 1 = Zip,State. 2 = Zip-Zip4,StateCode. 3 = Zip-Zip4,State"),
 }, async ({ text, display_type }) => {
     try {
-        const response = await client.autocompleteZipCode(text, display_type);
+        const response = await getClient().autocompleteZipCode(text, display_type);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -117,7 +118,7 @@ server.tool("sthan_geocode", "Convert a US address to latitude/longitude coordin
         .describe("US address to geocode (freeform text). Example: '1600 Pennsylvania Ave, Washington DC'"),
 }, async ({ address }) => {
     try {
-        const response = await client.geocodeAddress(address);
+        const response = await getClient().geocodeAddress(address);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -132,7 +133,7 @@ server.tool("sthan_reverse_geocode", "Convert latitude/longitude coordinates to
     longitude: zod_1.z.number().min(-180).max(180).describe("Longitude coordinate"),
 }, async ({ latitude, longitude }) => {
     try {
-        const response = await client.reverseGeocode(latitude, longitude);
+        const response = await getClient().reverseGeocode(latitude, longitude);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };
@@ -148,7 +149,7 @@ server.tool("sthan_ip_geolocation", "Look up the geographic location of an IPv4
         .describe("IPv4 (e.g. '8.8.8.8') or IPv6 (e.g. '2001:4860:4860::8888') address"),
 }, async ({ ip }) => {
     try {
-        const response = await client.ipGeolocation(ip);
+        const response = await getClient().ipGeolocation(ip);
         return {
             content: [{ type: "text", text: JSON.stringify(response.Result, null, 2) }],
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sthan/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "mcpName": "io.github.sthan-io/mcp-server",
   "description": "MCP server for sthan.io — US address verification, parsing, autocomplete, geocoding, and IP geolocation",
   "main": "dist/index.js",
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "@sthan/core": "0.1.1"
+    "@sthan/core": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",