Merge pull request #33 from isaacus-dev/release-please--branches--main--changes--next--components--isaacus

release: 0.5.0

Author: umarbutler

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.4.0"
+  ".": "0.5.0"
 }

CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.5.0 (2025-04-05)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **mcp:** support end-user filtering of tools, resources, and tags ([#35](https://github.com/isaacus-dev/isaacus-typescript/issues/35)) ([c3c597f](https://github.com/isaacus-dev/isaacus-typescript/commit/c3c597f21cebbb6e14e9b87fa87d543697afeb7f))
+
+
+### Bug Fixes
+
+* **api:** improve type resolution when importing as a package ([#37](https://github.com/isaacus-dev/isaacus-typescript/issues/37)) ([db9ceca](https://github.com/isaacus-dev/isaacus-typescript/commit/db9ceca29582d073446736def120d22a2d75a9c9))
+* **client:** send `X-Stainless-Timeout` in seconds ([#34](https://github.com/isaacus-dev/isaacus-typescript/issues/34)) ([979c453](https://github.com/isaacus-dev/isaacus-typescript/commit/979c453293006d0f841901df8f3383f5785b00a6))
+* **mcp:** remove debug logging ([#39](https://github.com/isaacus-dev/isaacus-typescript/issues/39)) ([91f4483](https://github.com/isaacus-dev/isaacus-typescript/commit/91f4483b3fef0e215ec59dfb10f557efce6fc3fe))
+
+
+### Chores
+
+* **internal:** add aliases for Record and Array ([#36](https://github.com/isaacus-dev/isaacus-typescript/issues/36)) ([f2f08fa](https://github.com/isaacus-dev/isaacus-typescript/commit/f2f08fa2f6fcec5979d6c575dbd0347b8af77123))
+* **internal:** version bump ([#32](https://github.com/isaacus-dev/isaacus-typescript/issues/32)) ([e1992ce](https://github.com/isaacus-dev/isaacus-typescript/commit/e1992ce3ade04471fdd437d753af418ed80836f4))
+
+
+### Documentation
+
+* **mcp:** improve MCP readme docs ([#38](https://github.com/isaacus-dev/isaacus-typescript/issues/38)) ([2bb3f29](https://github.com/isaacus-dev/isaacus-typescript/commit/2bb3f29e9a41b834f17783cd26cce1bfb3e5c5ed))
+* **mcp:** update env vars in README ([#40](https://github.com/isaacus-dev/isaacus-typescript/issues/40)) ([5cc72f4](https://github.com/isaacus-dev/isaacus-typescript/commit/5cc72f48910c6721213b17eb569d075b4d584b14))
+
 ## 0.4.0 (2025-04-01)
 
 Full Changelog: [v0.3.1...v0.4.0](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.3.1...v0.4.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacus",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The official TypeScript library for the Isaacus API",
   "author": "Isaacus <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -4,18 +4,21 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 ## Installation
 
-### Via Claude Desktop
+### Direct invocation
 
-See [the user guide](https://modelcontextprotocol.io/quickstart/user) for setup.
+You can run the MCP Server directly via `npx`:
 
-Once it's set up, add your MCP server to your `claude_desktop_config.json` file to enable it.
+```sh
+export ISAACUS_API_KEY="My API Key"
+npx -y isaacus-mcp
+```
 
-The configuration file should be at:
+### Via MCP Client
 
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+There is a partial list of existing clients at [modelcontextprotocol.io](https://modelcontextprotocol.io/clients). If you already
+have a client, consult their documentation to install the MCP server.
 
-Add the following value to your `mcpServers` section. Make sure to provide any necessary environment variables (like API keys) as well.
+For clients with a configuration JSON, it might look something like this:
 
 ```json
 {
@@ -30,3 +33,68 @@ Add the following value to your `mcpServers` section. Make sure to provide any n
   }
 }
 ```
+
+## Filtering tools
+
+You can run the package on the command line to discover and filter the set of tools that are exposed by the
+MCP Server. This can be helpful for large APIs where including all endpoints at once is too much for your AI's
+context window.
+
+You can filter by multiple aspects:
+
+- `--tool` includes a specific tool by name
+- `--resource` includes all tools under a specific resource, and can have wildcards, e.g. `my.resource*`
+- `--operation` includes just read (get/list) or just write operations
+
+See more information with `--help`.
+
+All of these command-line options can be repeated, combined together, and have corresponding exclusion versions (e.g. `--no-tool`).
+
+Use `--list` to see the list of available tools, or see below.
+
+## Importing the tools and server individually
+
+```js
+// Import the server, generated endpoints, or the init function
+import { server, endpoints, init } from "isaacus-mcp/server";
+
+// import a specific tool
+import createClassificationsUniversal from "isaacus-mcp/tools/classifications/universal/create-classifications-universal";
+
+// initialize the server and all endpoints
+init({ server, endpoints });
+
+// manually start server
+const transport = new StdioServerTransport();
+await server.connect(transport);
+
+// or initialize your own server with specific tools
+const myServer = new McpServer(...);
+
+// define your own endpoint
+const myCustomEndpoint = {
+  tool: {
+    name: 'my_custom_tool',
+    description: 'My custom tool',
+    inputSchema: zodToJsonSchema(z.object({ a_property: z.string() })),
+  },
+  handler: async (client: client, args: any) => {
+    return { myResponse: 'Hello world!' };
+  })
+};
+
+// initialize the server with your custom endpoints
+init({ server: myServer, endpoints: [createClassificationsUniversal, myCustomEndpoint] });
+```
+
+## Available Tools
+
+The following tools are available in this MCP server.
+
+### Resource `classifications.universal`:
+
+- `create_classifications_universal` (`write`): Classify the relevance of a legal document to a query with an Isaacus universal legal AI classifier.
+
+### Resource `rerankings`:
+
+- `create_rerankings` (`write`): Rerank legal documents by their relevance to a query with an Isaacus legal AI reranker.

packages/mcp-server/build

@@ -24,16 +24,7 @@ node scripts/postprocess-dist-package-json.cjs
 
 # build to .js/.mjs/.d.ts files
 npm exec tsc-multi
-# we need to add exports = module.exports = Anthropic TypeScript to index.js;
-# No way to get that from index.ts because it would cause compile errors
-# when building .mjs
-DIST_PATH=./dist node ../../scripts/utils/fix-index-exports.cjs
-
-# with "moduleResolution": "nodenext", if ESM resolves to index.d.ts,
-# it'll have TS errors on the default import.  But if it resolves to
-# index.d.mts the default import will work (even though both files have
-# the same export default statement)
-cp dist/index.d.ts dist/index.d.mts
+
 cp tsconfig.dist-src.json dist/src/tsconfig.json
 
 # Add proper Node.js shebang to the top of the file

packages/mcp-server/jest.config.ts

@@ -0,0 +1,17 @@
+import type { JestConfigWithTsJest } from 'ts-jest';
+
+const config: JestConfigWithTsJest = {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.(t|j)sx?$': ['@swc/jest', { sourceMaps: 'inline' }],
+  },
+  moduleNameMapper: {
+    '^isaacus-mcp$': '<rootDir>/src/index.ts',
+    '^isaacus-mcp/(.*)$': '<rootDir>/src/$1',
+  },
+  modulePathIgnorePatterns: ['<rootDir>/dist/'],
+  testPathIgnorePatterns: ['scripts'],
+};
+
+export default config;

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacus-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The official MCP Server for the Isaacus API",
   "author": "Isaacus <[email protected]>",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
   "packageManager": "[email protected]",
   "private": false,
   "scripts": {
-    "test": "echo 'no tests defined yet' && exit 1",
+    "test": "jest",
     "build": "bash ./build",
     "prepack": "echo 'to pack, run yarn build && (cd dist; yarn pack)' && exit 1",
     "prepublishOnly": "echo 'to publish, run yarn build && (cd dist; yarn publish)' && exit 1",
@@ -23,7 +23,8 @@
   },
   "dependencies": {
     "isaacus": "file:../../dist/",
-    "@modelcontextprotocol/sdk": "^1.6.1"
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "yargs": "^17.7.2"
   },
   "bin": {
     "mcp-server": "dist/index.js"
@@ -40,7 +41,7 @@
     "ts-jest": "^29.1.0",
     "ts-morph": "^19.0.0",
     "ts-node": "^10.5.0",
-    "tsc-multi": "^1.1.0",
+    "tsc-multi": "https://github.com/stainless-api/tsc-multi/releases/download/v1.1.3/tsc-multi.tgz",
     "tsconfig-paths": "^4.0.0",
     "typescript": "^4.8.2"
   },
@@ -50,23 +51,12 @@
   },
   "exports": {
     ".": {
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "types": "./dist/index.d.mts",
+      "require": "./dist/index.js",
       "default": "./dist/index.mjs"
     },
-    "./*.mjs": {
-      "types": "./dist/*.d.ts",
-      "default": "./dist/*.mjs"
-    },
-    "./*.js": {
-      "types": "./dist/*.d.ts",
-      "default": "./dist/*.js"
-    },
+    "./*.mjs": "./dist/*.mjs",
+    "./*.js": "./dist/*.js",
     "./*": {
-      "types": "./dist/*.d.ts",
       "require": "./dist/*.js",
       "default": "./dist/*.mjs"
     }