chore: configure new SDK language

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Bootstrap
         run: ./scripts/bootstrap
@@ -46,7 +46,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Bootstrap
         run: ./scripts/bootstrap
@@ -68,6 +68,15 @@ jobs:
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
           SHA: ${{ github.sha }}
         run: ./scripts/utils/upload-artifact.sh
+
+      - name: Upload MCP Server tarball
+        if: github.repository == 'stainless-sdks/hanzo-ai-typescript'
+        env:
+          URL: https://pkg.stainless.com/s?subpackage=mcp-server
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          BASE_PATH: packages/mcp-server
+        run: ./scripts/utils/upload-artifact.sh
   test:
     timeout-minutes: 10
     name: test

.gitignore

@@ -7,4 +7,5 @@ dist
 dist-deno
 /*.tgz
 .idea/
-
+dist-bundle
+*.dxt

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 188
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hanzo-industries-inc%2Fhanzo-ai-2d6e1036fb1eea7e95cafc281141ead9ef77796e43711b17edccaab67c5e791a.yml
 openapi_spec_hash: 12501774d0127be4ec1812d613a58e97
-config_hash: 830747463ff4d018b5633ce511e88558
+config_hash: 5b61cc8c6c31c071a08578ad825b421d

bin/publish-npm

@@ -58,4 +58,4 @@ else
 fi
 
 # Publish with the appropriate tag
-yarn publish --access public --tag "$TAG"
+yarn publish --tag "$TAG"

package.json

@@ -13,6 +13,9 @@
     "**/*"
   ],
   "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "./scripts/test",
     "build": "./scripts/build",
@@ -41,15 +44,12 @@
     "publint": "^0.2.12",
     "ts-jest": "^29.1.0",
     "ts-node": "^10.5.0",
-    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.8/tsc-multi.tgz",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.9/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0",
+    "tslib": "^2.8.1",
     "typescript": "5.8.3",
     "typescript-eslint": "8.31.1"
   },
-  "imports": {
-    "hanzoai": ".",
-    "hanzoai/*": "./src/*"
-  },
   "exports": {
     ".": {
       "import": "./dist/index.mjs",

packages/mcp-server/README.md

@@ -128,6 +128,43 @@ over time, you can manually enable or disable certain capabilities:
 --resource=cards,accounts --operation=read --tag=kyc --no-tool=create_cards
 ```
 
+## Running remotely
+
+Launching the client with `--transport=http` launches the server as a remote server using Streamable HTTP transport. The `--port` setting can choose the port it will run on, and the `--socket` setting allows it to run on a Unix socket.
+
+Authorization can be provided via the following headers:
+| Header | Equivalent client option | Security scheme |
+| --------------------------- | ------------------------ | --------------- |
+| `Ocp-Apim-Subscription-Key` | `apiKey` | APIKeyHeader |
+
+A configuration JSON for this server might look like this, assuming the server is hosted at `http://localhost:3000`:
+
+```json
+{
+  "mcpServers": {
+    "hanzoai_api": {
+      "url": "http://localhost:3000",
+      "headers": {
+        "Ocp-Apim-Subscription-Key": "My API Key"
+      }
+    }
+  }
+}
+```
+
+The command-line arguments for filtering tools and specifying clients can also be used as query parameters in the URL.
+For example, to exclude specific tools while including others, use the URL:
+
+```
+http://localhost:3000?resource=cards&resource=accounts&no_tool=create_cards
+```
+
+Or, to configure for the Cursor client, with a custom max tool name length, use the URL:
+
+```
+http://localhost:3000?client=cursor&capability=tool-name-length%3D40
+```
+
 ## Importing the tools and server individually
 
 ```js

packages/mcp-server/build

@@ -30,3 +30,27 @@ cp tsconfig.dist-src.json dist/src/tsconfig.json
 chmod +x dist/index.js
 
 DIST_PATH=./dist PKG_IMPORT_PATH=hanzoai-mcp/ node ../../scripts/utils/postprocess-files.cjs
+
+# mcp bundle
+rm -rf dist-bundle hanzoai_api.dxt; mkdir dist-bundle
+
+# copy package.json
+PKG_JSON_PATH=../../packages/mcp-server/package.json node ../../scripts/utils/make-dist-package-json.cjs > dist-bundle/package.json
+
+# copy files
+node scripts/copy-bundle-files.cjs
+
+# install runtime deps
+cd dist-bundle
+npm install
+cd ..
+
+# pack bundle
+cp manifest.json dist-bundle
+
+npx dxt pack dist-bundle hanzoai_api.dxt
+
+npx dxt sign hanzoai_api.dxt --self-signed
+
+# clean up
+rm -rf dist-bundle

packages/mcp-server/manifest.json

@@ -0,0 +1,42 @@
+{
+  "dxt_version": "0.1",
+  "name": "hanzoai-mcp",
+  "version": "0.1.0-alpha.1",
+  "description": "The official MCP Server for the Hanzo API",
+  "author": {
+    "name": "Hanzo",
+    "email": "[email protected]"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hanzoai/js-sdk.git"
+  },
+  "homepage": "https://github.com/hanzoai/js-sdk/tree/main/packages/mcp-server#readme",
+  "documentation": "https://docs.hanzo.ai",
+  "server": {
+    "type": "node",
+    "entry_point": "${__dirname}/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/index.js"],
+      "env": {
+        "HANZO_API_KEY": "${user_config.HANZO_API_KEY}"
+      }
+    }
+  },
+  "user_config": {
+    "HANZO_API_KEY": {
+      "title": "api_key",
+      "description": "The default name of the subscription key header of Azure",
+      "required": true,
+      "type": "string"
+    }
+  },
+  "tools_generated": true,
+  "compatibility": {
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  },
+  "keywords": ["api"]
+}

packages/mcp-server/package.json

@@ -15,6 +15,9 @@
   "license": "Apache-2.0",
   "packageManager": "[email protected]",
   "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "jest",
     "build": "bash ./build",
@@ -28,18 +31,28 @@
   },
   "dependencies": {
     "hanzoai": "file:../../dist/",
+    "@cloudflare/cabidela": "^0.2.4",
     "@modelcontextprotocol/sdk": "^1.11.5",
-    "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.2/jq-web.tar.gz",
+    "@valtown/deno-http-worker": "^0.0.21",
+    "cors": "^2.8.5",
+    "express": "^5.1.0",
+    "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.6/jq-web.tar.gz",
+    "qs": "^6.14.0",
     "yargs": "^17.7.2",
-    "@cloudflare/cabidela": "^0.2.4",
     "zod": "^3.25.20",
-    "zod-to-json-schema": "^3.24.5"
+    "zod-to-json-schema": "^3.24.5",
+    "zod-validation-error": "^4.0.1"
   },
   "bin": {
     "mcp-server": "dist/index.js"
   },
   "devDependencies": {
+    "@anthropic-ai/dxt": "^0.2.6",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.3",
     "@types/jest": "^29.4.0",
+    "@types/qs": "^6.14.0",
+    "@types/yargs": "^17.0.8",
     "@typescript-eslint/eslint-plugin": "8.31.1",
     "@typescript-eslint/parser": "8.31.1",
     "eslint": "^8.49.0",
@@ -50,7 +63,7 @@
     "ts-jest": "^29.1.0",
     "ts-morph": "^19.0.0",
     "ts-node": "^10.5.0",
-    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.8/tsc-multi.tgz",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.9/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0",
     "typescript": "5.8.3"
   },

packages/mcp-server/scripts/copy-bundle-files.cjs

@@ -0,0 +1,36 @@
+const fs = require('fs');
+const path = require('path');
+const pkgJson = require('../dist-bundle/package.json');
+
+const distDir = path.resolve(__dirname, '..', 'dist');
+const distBundleDir = path.resolve(__dirname, '..', 'dist-bundle');
+const distBundlePkgJson = path.join(distBundleDir, 'package.json');
+
+async function* walk(dir) {
+  for await (const d of await fs.promises.opendir(dir)) {
+    const entry = path.join(dir, d.name);
+    if (d.isDirectory()) yield* walk(entry);
+    else if (d.isFile()) yield entry;
+  }
+}
+
+async function copyFiles() {
+  // copy runtime files
+  for await (const file of walk(distDir)) {
+    if (!/[cm]?js$/.test(file)) continue;
+    const dest = path.join(distBundleDir, path.relative(distDir, file));
+    await fs.promises.mkdir(path.dirname(dest), { recursive: true });
+    await fs.promises.copyFile(file, dest);
+  }
+
+  // replace package.json reference with local reference
+  for (const dep in pkgJson.dependencies) {
+    if (dep === 'hanzoai') {
+      pkgJson.dependencies[dep] = 'file:../../../dist/';
+    }
+  }
+
+  await fs.promises.writeFile(distBundlePkgJson, JSON.stringify(pkgJson, null, 2));
+}
+
+copyFiles();