@ractive-ch/tab-mcp 0.5.1 → 0.6.1

package/README.md

@@ -10,14 +10,14 @@ and gets an MCP address. The user adds that address to an AI app and pairs it by
 a code from the page on the relay's sign-in page. The relay then forwards the AI app's
 requests to the page. It knows nothing about the tools themselves.
 
-**Status: 0.5.1.** Until 1.0, a new minor version can still change settings and the API.
+**Status: 0.6.1.** Until 1.0, a new minor version can still change settings and the API.
 The relay speaks MCP revision 2026-07-28 only and accepts AI apps that register through
 OAuth Client ID Metadata Documents; see [compatibility](https://github.com/ractive/tab-mcp/blob/main/docs/compatibility.md)
 for which apps work.
 
 ## Run it
 
-The relay needs [Bun](https://bun.sh) 1.4.3 or newer. It does not run on Node.js.
+The relay needs [Bun](https://bun.sh) 1.4.4 or newer. It does not run on Node.js.
 
 ```sh
 bun add --global @ractive-ch/tab-mcp
@@ -32,7 +32,7 @@ Or with Docker (linux/amd64 and linux/arm64):
 docker run -d -p 127.0.0.1:8080:8080 -v tab-mcp-data:/data \
   -e TAB_MCP_PUBLIC_URL=https://relay.example.com \
   -e TAB_MCP_ALLOWED_ORIGINS=https://app.example.com \
-  ractive/tab-mcp:0.5.1
+  ractive/tab-mcp:0.6.1
 ```
 
 The image is also on `ghcr.io/ractive/tab-mcp`. Put the relay behind a reverse proxy
@@ -112,6 +112,25 @@ tokenStoreConformance("MyTokenStore", () => new MyTokenStore());
 [Token store](https://github.com/ractive/tab-mcp/blob/main/docs/token-store.md) explains
 the interface, its guarantees and a Redis example.
 
+### Testing a page's tools
+
+For end-to-end tests under `bun test`, `startTestRelay()` runs a relay in the test
+process (127.0.0.1, a free port, development mode, every page origin allowed, a memory
+store, no log output unless `logger` or `logLevel` is given; options override any of that), and `tokenFor()` writes a token for
+a page's MCP address into its store, as if an AI app had paired:
+
+```ts
+import { startTestRelay, tokenFor } from "@ractive-ch/tab-mcp/testing";
+
+const relay = startTestRelay();
+// The page connects with `relay: relay.url`; its address is `session.address`.
+const token = await tokenFor(relay.store, address);
+// Any MCP client, with the header `Authorization: Bearer ${token}`.
+await relay.stop();
+```
+
+It is for tests only: it accepts every origin and skips pairing.
+
 ## Security
 
 Connecting an AI app to a page means trusting that page, as with any MCP server. The