@stratabook/mcp 0.1.0 → 0.1.2

package/README.md

@@ -72,8 +72,7 @@ npx -y @modelcontextprotocol/inspector --cli \
   --tool-name strata_quote \
   --tool-arg market=SOL/USDC \
   --tool-arg side=sell \
-  --tool-arg 'amountInAtoms="10000000"' \
-  --tool-arg slippageBps=50
+  --tool-arg 'amountInAtoms="10000000"'
 ```
 
 The response is structured data, ready for terminals, scripts, and agents.
@@ -92,8 +91,7 @@ The response is structured data, ready for terminals, scripts, and agents.
 {
   "market": "SOL/USDC",
   "side": "sell",
-  "amountInAtoms": "10000000",
-  "slippageBps": 50
+  "amountInAtoms": "10000000"
 }
 ```
 
@@ -104,7 +102,7 @@ The result gives an agent the economics it needs to reason clearly:
   "provider": "Sonar",
   "amount_in_consumed_atoms": "10000000",
   "amount_out_atoms": "1990000",
-  "minimum_output_atoms": "1980050",
+  "minimum_output_atoms": "1990000",
   "output_fee_atoms": "995",
   "reference_price": "199.1",
   "price_impact_pct": "0.0005"
@@ -116,6 +114,13 @@ also include a unique quote ID and authoritative expiry.
 
 Sonar handles the market. Your agent works with one economic result.
 
+### Execution tolerance
+
+Quotes default to exact output: `minimum_output_atoms` equals
+`amount_out_atoms`. An agent may explicitly provide `slippageBps` when its task
+accepts a lower minimum output. This is an execution safeguard, not an estimate
+of market depth; `price_impact_pct` reports price impact separately.
+
 ## Hosted or local
 
 | | Hosted Streamable HTTP | Local stdio |

package/dist/src/cli.js

@@ -4,6 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { DEFAULT_API_BASE } from "@stratabook/sdk";
 import { createStrataMcpServer } from "./server.js";
+import { SERVER_VERSION } from "./version.js";
 function parse(argv) {
     const values = new Map();
     for (let index = 0; index < argv.length; index++) {
@@ -26,7 +27,7 @@ function parse(argv) {
     }
     const timeoutMs = boundedInteger(values.get("timeout-ms") ?? process.env.STRATA_MCP_TIMEOUT_MS ?? "10000", "timeout-ms", 250, 60_000);
     const port = boundedInteger(values.get("port") ?? process.env.STRATA_MCP_PORT ?? "8787", "port", 1, 65_535);
-    const host = values.get("host") ?? process.env.STRATA_MCP_HOST ?? "127.0.0.1";
+    const host = values.get("host") ?? process.env.STRATA_MCP_HOST ?? "localhost";
     if (!/^[a-zA-Z0-9.:[\]-]+$/.test(host))
         throw new Error("host is invalid");
     return {
@@ -49,13 +50,13 @@ function help() {
 
 Usage:
   strata-mcp
-  strata-mcp --transport http [--host 127.0.0.1] [--port 8787]
+  strata-mcp --transport http [--host localhost] [--port 8787]
 
 Options:
   --transport stdio|http   Local stdio by default; Streamable HTTP for hosting
   --api-base URL           Strata public API (default: ${DEFAULT_API_BASE})
   --timeout-ms N           Upstream timeout, 250..60000 (default: 10000)
-  --host HOST              HTTP bind host (default: 127.0.0.1)
+  --host HOST              HTTP bind host (default: localhost)
   --port N                 HTTP port (default: 8787)
 
 This server is read-only. It accepts no wallet, private key, or session key.
@@ -81,7 +82,7 @@ async function runHttp(options) {
         response
             .status(200)
             .set("Cache-Control", "no-store")
-            .json({ ok: true, service: "strata-mcp", version: "0.1.0" });
+            .json({ ok: true, service: "strata-mcp", version: SERVER_VERSION });
     });
     app.post("/mcp", async (request, response) => {
         let runtime;

package/dist/src/server.js

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StrataApiError, StrataClient, } from "@stratabook/sdk";
+import { DEFAULT_SLIPPAGE_BPS, StrataApiError, StrataClient, } from "@stratabook/sdk";
 import * as z from "zod/v4";
-const SERVER_VERSION = "0.1.0";
+import { SERVER_VERSION } from "./version.js";
 const REFRESH_INTERVAL_MS = 5_000;
 export function capabilityAvailable(catalog, id) {
     return catalog.capabilities.some((capability) => capability.id === id
@@ -82,8 +82,9 @@ export async function createStrataMcpServer(options = {}) {
                 .min(0)
                 .max(1_000)
                 .optional()
-                .default(50)
-                .describe("Maximum slippage in basis points."),
+                .default(DEFAULT_SLIPPAGE_BPS)
+                .describe("Optional maximum execution tolerance in basis points. "
+                + "The default 0 requires exact quoted output."),
         },
         annotations: {
             readOnlyHint: true,

package/dist/src/version.d.ts

@@ -0,0 +1 @@
+export declare const SERVER_VERSION: string;

package/dist/src/version.js

@@ -0,0 +1,4 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const packageMetadata = require("../../package.json");
+export const SERVER_VERSION = packageMetadata.version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratabook/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Connect AI agents to Strata markets and Sonar quotes with MCP.",
   "type": "module",
   "license": "MIT OR Apache-2.0",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@stratabook/sdk": "0.1.0",
+    "@stratabook/sdk": "0.1.1",
     "zod": "^3.25.76"
   },
   "devDependencies": {