@thehikingworld/mcp 1.1.0 → 1.1.2

package/README.md

@@ -1,38 +1,46 @@
-# @thehikingworld/mcp
-
-Read-only access to [The Hiking World](https://www.thehikingworld.com): sourced, dated trail and permit records. A figure is returned only when the catalog stored it. Unverified fees stay labelled unverified. Null means not recorded.
-
-Geometry is OpenStreetMap, ODbL. Editorial text is The Hiking World. Permit tariffs stay the issuer's. Cite the trail URL and the verified date.
-
-## Install
-
-```bash
-npx -y @thehikingworld/mcp
-```
-
-Claude Desktop:
-
-```json
-{
-  "mcpServers": {
-    "thehikingworld": {
-      "command": "npx",
-      "args": ["-y", "@thehikingworld/mcp"]
-    }
-  }
-}
-```
-
-The process speaks MCP on stdin/stdout. `THW_API_BASE` overrides the default origin `https://www.thehikingworld.com`.
-
-## Hosted
-
-`https://www.thehikingworld.com/api/mcp` is the same tool set over Streamable HTTP. No install. No API key. Read-only.
-
-## Tools
-
-`get_trail`, `search_trails`, `get_permit`, `get_updates`, `list_regions`, `list_countries`, `get_geojson`, `get_provenance`.
-
-`get_updates` returns confirmed fee changes, newest first, each with a citation. `get_permit` and `get_trail` carry the citation string when a fee is citeable.
-
-If the feed is down, the tool returns an error and the process stays up.
+# @thehikingworld/mcp
+
+Read-only access to [The Hiking World](https://www.thehikingworld.com): sourced, dated trail and permit records. A figure is returned only when the catalog stored it. Unverified fees stay labelled unverified. Null means not recorded.
+
+Geometry is OpenStreetMap, ODbL. Editorial text is The Hiking World. That citation request is not a licence. Permit tariffs stay the issuer's.
+
+Cite one number, not only the page:
+
+`https://www.thehikingworld.com/trails/inca-trail#fact-ascent`
+
+`https://www.thehikingworld.com/api/v1/facts/inca-trail/ascent`
+
+The JSON carries value, tier, source, verified date, and the record signature. A withheld ascent is null.
+
+## Install
+
+```bash
+npx -y @thehikingworld/mcp
+```
+
+Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "thehikingworld": {
+      "command": "npx",
+      "args": ["-y", "@thehikingworld/mcp"]
+    }
+  }
+}
+```
+
+The process speaks MCP on stdin/stdout. `THW_API_BASE` overrides the default origin `https://www.thehikingworld.com`.
+
+## Hosted
+
+`https://www.thehikingworld.com/api/mcp` is the same tool set over Streamable HTTP. No install. No API key. Read-only.
+
+## Tools
+
+`get_trail`, `search_trails`, `get_permit`, `plan_permits`, `get_updates`, `list_regions`, `list_countries`, `get_geojson`, `get_provenance`.
+
+`get_permit` returns costLocal, tier, issuer, sourceUrl, and readDate. The tier is the record's status. A reported or unverified row is not an official fee. A null costLocal is not a number. `get_updates` returns confirmed fee changes, newest first, each with a citation. `get_permit` and `get_trail` carry the citation string when a fee is citeable. `plan_permits` takes one or more trail slugs and returns the stored permit rows for each, summing only confident same-currency official figures; a mixed or unverified set keeps a null total. It is a reference, not a route planner or a booking step.
+
+If the feed is down, the tool returns an error and the process stays up.

package/dist/index.js

@@ -5,7 +5,7 @@ import { pathToFileURL } from "node:url";
 import { registerTools } from "./tools.js";
 export { filterSummaries, matchPermits, registerTools } from "./tools.js";
 async function main() {
-    const server = new McpServer({ name: "thehikingworld", version: "1.1.0" });
+    const server = new McpServer({ name: "thehikingworld", version: "1.1.2" });
     registerTools(server);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools.js

@@ -161,7 +161,7 @@ export function registerTools(server) {
         });
     });
     server.registerTool("get_permit", {
-        description: `Permit rows from /api/v1/permits for a slug or a name ("Manaslu", "EBC"). Ambiguous names return candidates instead of a guess. Every row keeps status and verifiedDate. ${HONESTY}${VERIFY_NOTE}`,
+        description: `Sourced permit fee for a named trail: local-currency costLocal, tier, issuer, source URL, and read-date. tier is verified-official, reported-secondary, or unverified. Do not quote reported-secondary or unverified as official. A null costLocal is not a number. Ambiguous names return candidates. ${HONESTY}${VERIFY_NOTE}`,
         inputSchema: { trail: z.string().describe("Slug or trail name") },
     }, async ({ trail }) => {
         const result = await getJson("/api/v1/permits");
@@ -186,7 +186,18 @@ export function registerTools(server) {
             schemaVersion: result.body.schemaVersion,
             generatedAt: result.body.generatedAt,
             license: result.body.license,
-            data: found.rows,
+            verify: { keyId: "3ad491a01aea", url: `${baseUrl()}/verify` },
+            data: found.rows.map((row) => ({
+                trailSlug: row.trailSlug,
+                trailName: row.trailName,
+                country: row.country,
+                permitType: row.permitType,
+                costLocal: row.costLocal,
+                tier: row.status,
+                issuer: row.issuer,
+                sourceUrl: row.sourceUrl,
+                readDate: row.verifiedDate,
+            })),
         });
     });
     server.registerTool("list_regions", {

package/package.json

@@ -1,38 +1,42 @@
-{
-  "name": "@thehikingworld/mcp",
-  "version": "1.1.0",
-  "description": "MCP server for The Hiking World sourced trail catalog.",
-  "type": "module",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://gitlab.com/ravitejarx/the-hiking-world.git",
-    "directory": "packages/mcp"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "thehikingworld-mcp": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "start": "node dist/index.js"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.32.1",
-    "zod": "^3.25.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.6.0"
-  }
-}
+{
+  "name": "@thehikingworld/mcp",
+  "version": "1.1.2",
+  "mcpName": "com.thehikingworld/mcp",
+  "description": "Read-only sourced trail facts. get_permit returns costLocal, tier, issuer, sourceUrl, and readDate. A reported or unverified row is not an official fee. A missing value stays empty. Verify a signature at https://www.thehikingworld.com/verify (integrity, not currency).",
+  "homepage": "https://www.thehikingworld.com/developers",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/ravitejarx/the-hiking-world.git",
+    "directory": "packages/mcp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "thehikingworld-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/server.json

@@ -0,0 +1,12 @@
+{
+  "name": "com.thehikingworld/mcp",
+  "description": "Read-only trail facts. Each permit row includes the local-currency figure, tier, issuer, source URL, and read-date. A signature can be checked at https://www.thehikingworld.com/verify with public key id 3ad491a01aea. This listing does not state a coverage count.",
+  "version": "1.1.2",
+  "packages": [
+    {
+      "registry_type": "npm",
+      "identifier": "@thehikingworld/mcp",
+      "transport": { "type": "stdio" }
+    }
+  ]
+}