@stratabook/mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -72,8 +72,7 @@ npx -y @modelcontextprotocol/inspector --cli \
72
72
  --tool-name strata_quote \
73
73
  --tool-arg market=SOL/USDC \
74
74
  --tool-arg side=sell \
75
- --tool-arg 'amountInAtoms="10000000"' \
76
- --tool-arg slippageBps=50
75
+ --tool-arg 'amountInAtoms="10000000"'
77
76
  ```
78
77
 
79
78
  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.
92
91
  {
93
92
  "market": "SOL/USDC",
94
93
  "side": "sell",
95
- "amountInAtoms": "10000000",
96
- "slippageBps": 50
94
+ "amountInAtoms": "10000000"
97
95
  }
98
96
  ```
99
97
 
@@ -104,7 +102,7 @@ The result gives an agent the economics it needs to reason clearly:
104
102
  "provider": "Sonar",
105
103
  "amount_in_consumed_atoms": "10000000",
106
104
  "amount_out_atoms": "1990000",
107
- "minimum_output_atoms": "1980050",
105
+ "minimum_output_atoms": "1990000",
108
106
  "output_fee_atoms": "995",
109
107
  "reference_price": "199.1",
110
108
  "price_impact_pct": "0.0005"
@@ -116,6 +114,13 @@ also include a unique quote ID and authoritative expiry.
116
114
 
117
115
  Sonar handles the market. Your agent works with one economic result.
118
116
 
117
+ ### Execution tolerance
118
+
119
+ Quotes default to exact output: `minimum_output_atoms` equals
120
+ `amount_out_atoms`. An agent may explicitly provide `slippageBps` when its task
121
+ accepts a lower minimum output. This is an execution safeguard, not an estimate
122
+ of market depth; `price_impact_pct` reports price impact separately.
123
+
119
124
  ## Hosted or local
120
125
 
121
126
  | | Hosted Streamable HTTP | Local stdio |
@@ -1,7 +1,7 @@
1
1
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- import { StrataApiError, StrataClient, } from "@stratabook/sdk";
2
+ import { DEFAULT_SLIPPAGE_BPS, StrataApiError, StrataClient, } from "@stratabook/sdk";
3
3
  import * as z from "zod/v4";
4
- const SERVER_VERSION = "0.1.0";
4
+ const SERVER_VERSION = "0.1.1";
5
5
  const REFRESH_INTERVAL_MS = 5_000;
6
6
  export function capabilityAvailable(catalog, id) {
7
7
  return catalog.capabilities.some((capability) => capability.id === id
@@ -82,8 +82,9 @@ export async function createStrataMcpServer(options = {}) {
82
82
  .min(0)
83
83
  .max(1_000)
84
84
  .optional()
85
- .default(50)
86
- .describe("Maximum slippage in basis points."),
85
+ .default(DEFAULT_SLIPPAGE_BPS)
86
+ .describe("Optional maximum execution tolerance in basis points. "
87
+ + "The default 0 requires exact quoted output."),
87
88
  },
88
89
  annotations: {
89
90
  readOnlyHint: true,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stratabook/mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Connect AI agents to Strata markets and Sonar quotes with MCP.",
5
5
  "type": "module",
6
6
  "license": "MIT OR Apache-2.0",
@@ -44,7 +44,7 @@
44
44
  },
45
45
  "dependencies": {
46
46
  "@modelcontextprotocol/sdk": "1.30.0",
47
- "@stratabook/sdk": "0.1.0",
47
+ "@stratabook/sdk": "0.1.1",
48
48
  "zod": "^3.25.76"
49
49
  },
50
50
  "devDependencies": {