@polar-sh/sdk 0.30.0 → 0.32.0

package/README.md

@@ -83,7 +83,7 @@ yarn add @polar-sh/sdk zod
 This SDK is also an installable MCP server where the various SDK methods are
 exposed as tools that can be invoked by AI applications.
 
-> Node.js v20 or greater is required to run the MCP server.
+> Node.js v20 or greater is required to run the MCP server from npm.
 
 <details>
 <summary>Claude installation steps</summary>
@@ -111,17 +111,50 @@ Add the following server definition to your `claude_desktop_config.json` file:
 <details>
 <summary>Cursor installation steps</summary>
 
-Go to `Cursor Settings > Features > MCP Servers > Add new MCP server` and use the following settings:
+Create a `.cursor/mcp.json` file in your project root with the following content:
 
-- Name: Polar
-- Type: `command`
-- Command:
-```sh
-npx -y --package @polar-sh/sdk -- mcp start --access-token ... 
+```json
+{
+  "mcpServers": {
+    "Polar": {
+      "command": "npx",
+      "args": [
+        "-y", "--package", "@polar-sh/sdk",
+        "--",
+        "mcp", "start",
+        "--access-token", "..."
+      ]
+    }
+  }
+}
 ```
 
 </details>
 
+You can also run MCP servers as a standalone binary with no additional dependencies. You must pull these binaries from available Github releases:
+
+```bash
+curl -L -o mcp-server \
+    https://github.com/{org}/{repo}/releases/download/{tag}/mcp-server-bun-darwin-arm64 && \
+chmod +x mcp-server
+```
+
+If the repo is a private repo you must add your Github PAT to download a release `-H "Authorization: Bearer {GITHUB_PAT}"`.
+
+
+```json
+{
+  "mcpServers": {
+    "Todos": {
+      "command": "./DOWNLOAD/PATH/mcp-server",
+      "args": [
+        "start"
+      ]
+    }
+  }
+}
+```
+
 For a full list of server arguments, run:
 
 ```sh