@moneolabs/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moneo Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# @moneolabs/mcp
+
+An MCP server that hands any agent host a guarded wallet — and, when you want it, trading —
+with keys the model never sees and a policy that runs before anything is signed. A refusal
+comes back as a result with a reason, not an exception, so the model reads why it was
+stopped instead of retrying into oblivion.
+
+## Try it in one command
+
+No API key, no account. The sandbox serves a funded wallet on an in-memory ledger with test
+funds and a simulated venue:
+
+```bash
+npx @moneolabs/mcp
+```
+
+### Claude Code
+
+```bash
+claude mcp add moneo -- npx @moneolabs/mcp
+```
+
+### Claude Desktop, Cursor, and friends
+
+```json
+{
+  "mcpServers": {
+    "moneo": {
+      "command": "npx",
+      "args": ["@moneolabs/mcp"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool                  | What it does                                                 |
+| --------------------- | ------------------------------------------------------------ |
+| `get_balance`         | Balance and what is not already committed                    |
+| `preflight_payment`   | Would this payment pass, without making it                   |
+| `pay`                 | Pay an address, invoice, or x402 endpoint; policy runs first |
+| `get_spending_limits` | Limits in force and what is left of each budget              |
+| `list_payments`       | Payments made this session                                   |
+| `get_quote`           | Price a trade across venues without committing               |
+| `execute_order`       | Quote and execute: market, limit, TWAP, or bracket           |
+| `list_positions`      | Open positions with cost basis and unrealized P&L            |
+| `close_position`      | Exit with the same guarantees as entry                       |
+
+## Configure the sandbox
+
+Environment variables, because MCP host configs pass env:
+
+| Variable        | Default                  |                                     |
+| --------------- | ------------------------ | ----------------------------------- |
+| `MONEO_AGENT`   | `sandbox-agent`          | Identity recorded on every decision |
+| `MONEO_FUNDING` | `5,000 USDG`             | Starting balance                    |
+| `MONEO_ASSET`   | `USDG`                   | Default asset                       |
+| `MONEO_POLICY`  | built-in cautious policy | Path to a policy JSON file          |
+
+```json
+{
+  "mcpServers": {
+    "moneo": {
+      "command": "npx",
+      "args": ["@moneolabs/mcp"],
+      "env": {
+        "MONEO_POLICY": "/etc/agents/overnight-policy.json",
+        "MONEO_FUNDING": "10,000 USDG"
+      }
+    }
+  }
+}
+```
+
+A policy file is the same shape `createGuard` takes:
+
+```json
+{
+  "perTransaction": { "max": "$400" },
+  "rolling24h": { "max": "$2,000" },
+  "velocity": { "max": 10, "per": "1h" },
+  "counterparties": "allowlist-only",
+  "allow": ["x402:*", "venue:*"],
+  "escalate": { "above": "$1,000" }
+}
+```
+
+## Serve your own wallet
+
+The sandbox is a default, not a ceiling. Wire the server to whatever signer and rail you
+run in production:
+
+```ts
+import { createMcpServer, serveStdio } from "@moneolabs/mcp";
+import { createGuard } from "@moneolabs/guard";
+import { createWallet } from "@moneolabs/wallet";
+
+const guard = createGuard(policy);
+const wallet = await createWallet({ agent: "ops-03", signer, rail, guard });
+
+await serveStdio(createMcpServer({ wallet, guard, trading }));
+```
+
+Part of [Moneo](https://github.com/moneolabs/moneo): autonomous finance for AI agents on
+Robinhood Chain. MIT.

package/dist/cli.js

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+
+// src/sandbox.ts
+import { readFileSync } from "fs";
+import { fixedPrices, registerAsset } from "@moneolabs/core";
+import { createGuard } from "@moneolabs/guard";
+import { createTrading, simulatedVenue } from "@moneolabs/trading";
+import { createWallet, localSigner, memoryRail } from "@moneolabs/wallet";
+var DEFAULT_POLICY = {
+  perTransaction: { max: "$500" },
+  rolling24h: { max: "$2,000" },
+  velocity: { max: 20, per: "1m" },
+  counterparties: "allowlist-only",
+  allow: ["x402:*", "venue:*", "vendor:*"],
+  escalate: { above: "$1,000" }
+};
+var SANDBOX_PRICES = {
+  AAPLX: 228.41,
+  TSLAX: 312.76,
+  NVDAX: 171.34,
+  SPYX: 563.02
+};
+async function createSandbox(options = {}) {
+  const agent = options.agent ?? process.env.MONEO_AGENT ?? "sandbox-agent";
+  const funding = options.funding ?? process.env.MONEO_FUNDING ?? "5,000 USDG";
+  const asset = options.asset ?? process.env.MONEO_ASSET ?? "USDG";
+  const policyPath = options.policyPath ?? process.env.MONEO_POLICY;
+  const policy = policyPath ? JSON.parse(readFileSync(policyPath, "utf8")) : DEFAULT_POLICY;
+  const guard = createGuard(policy, { agent, prices: fixedPrices(SANDBOX_PRICES) });
+  const wallet = await createWallet({
+    agent,
+    signer: localSigner(),
+    rail: memoryRail(),
+    asset,
+    guard,
+    funding
+  });
+  const prices = {};
+  for (const [symbol, usdg] of Object.entries(SANDBOX_PRICES)) {
+    registerAsset({ symbol, decimals: 18 });
+    prices[`${asset}/${symbol}`] = 1 / usdg;
+    prices[`${symbol}/${asset}`] = usdg;
+  }
+  const trading = createTrading({
+    agent,
+    guard,
+    quoteAsset: asset,
+    venues: [simulatedVenue({ name: "sandbox-pool", prices, feeRate: 5e-4 })]
+  });
+  return { wallet, guard, trading };
+}
+
+// src/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// src/tools.ts
+import { formatMoney } from "@moneolabs/core";
+import { PolicyDeniedError } from "@moneolabs/guard";
+import { toolkit } from "@moneolabs/wallet";
+function buildTools(options) {
+  const walletTools = toolkit(options.wallet, {
+    ...options.guard ? { guard: options.guard } : {},
+    ...options.include ? { include: options.include } : {}
+  });
+  const trading = options.trading;
+  const tradingTools = trading ? {
+    get_quote: {
+      definition: {
+        name: "get_quote",
+        description: "Price a trade across every venue that can fill it, without committing to anything. Returns the best route.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            sell: { type: "string", description: 'Asset given up, for example "USDG".' },
+            buy: { type: "string", description: 'Asset acquired, for example "AAPLX".' },
+            notional: {
+              type: "string",
+              description: 'How much to spend, for example "300 USDG".'
+            }
+          },
+          required: ["sell", "buy", "notional"]
+        }
+      },
+      async run(input) {
+        const quote = await trading.quote({
+          sell: String(input.sell),
+          buy: String(input.buy),
+          notional: String(input.notional)
+        });
+        return {
+          quoteId: quote.id,
+          venue: quote.venue,
+          sells: formatMoney(quote.sellAmount),
+          buys: formatMoney(quote.buyAmount),
+          price: quote.price,
+          fee: formatMoney(quote.fee),
+          impact: quote.impact,
+          expiresAt: new Date(quote.expiresAt).toISOString()
+        };
+      }
+    },
+    execute_order: {
+      definition: {
+        name: "execute_order",
+        description: "Quote and execute a trade. Policy runs before anything is signed: a refusal returns the reason and costs nothing. Attach takeProfit and stopLoss to ship the exit with the entry.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            sell: { type: "string", description: "Asset given up." },
+            buy: { type: "string", description: "Asset acquired." },
+            notional: { type: "string", description: 'How much to spend, e.g. "300 USDG".' },
+            type: {
+              type: "string",
+              enum: ["market", "limit", "twap", "bracket"],
+              description: "Order type. Defaults to market."
+            },
+            maxSlippage: {
+              type: "number",
+              description: "Largest acceptable adverse move as a fraction, e.g. 0.003. Exceeding it rejects the order instead of filling it worse."
+            },
+            limitPrice: { type: "number", description: "limit: price to rest at." },
+            window: {
+              type: "string",
+              description: 'twap: window to spread across, e.g. "30m".'
+            },
+            takeProfit: { type: "number", description: "bracket: exit price above." },
+            stopLoss: { type: "number", description: "bracket: exit price below." }
+          },
+          required: ["sell", "buy", "notional"]
+        }
+      },
+      async run(input) {
+        const orderOptions = {
+          ...input.type ? { type: input.type } : {},
+          ...typeof input.maxSlippage === "number" ? { maxSlippage: input.maxSlippage } : {},
+          ...typeof input.limitPrice === "number" ? { limitPrice: input.limitPrice } : {},
+          ...input.window ? { window: String(input.window) } : {},
+          ...typeof input.takeProfit === "number" ? { takeProfit: input.takeProfit } : {},
+          ...typeof input.stopLoss === "number" ? { stopLoss: input.stopLoss } : {}
+        };
+        try {
+          const quote = await trading.quote({
+            sell: String(input.sell),
+            buy: String(input.buy),
+            notional: String(input.notional)
+          });
+          const order = await trading.execute(quote, orderOptions);
+          return { ok: true, ...formatOrder(await order.settled()) };
+        } catch (error) {
+          if (error instanceof PolicyDeniedError) {
+            return {
+              ok: false,
+              refused: true,
+              reason: error.decision.reason,
+              rule: error.decision.rule,
+              hint: "This limit is set by the wallet owner. Ask them to raise it rather than retrying."
+            };
+          }
+          throw error;
+        }
+      }
+    },
+    list_positions: {
+      definition: {
+        name: "list_positions",
+        description: "Open positions with cost basis and unrealized P&L at the latest mark.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      async run() {
+        return trading.positions().map((p) => ({
+          asset: p.asset,
+          quantity: formatMoney(p.quantity),
+          averageCost: p.averageCost,
+          costBasis: formatMoney(p.costBasis),
+          marketValue: formatMoney(p.marketValue),
+          unrealized: formatMoney(p.unrealized),
+          realized: formatMoney(p.realized)
+        }));
+      }
+    },
+    close_position: {
+      definition: {
+        name: "close_position",
+        description: "Exit a position with the same guarantees the entry had: policy first, slippage bound enforced.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            asset: { type: "string", description: "Asset to close." },
+            maxSlippage: {
+              type: "number",
+              description: "Largest acceptable adverse move as a fraction."
+            }
+          },
+          required: ["asset"]
+        }
+      },
+      async run(input) {
+        try {
+          const order = await trading.close(String(input.asset), {
+            type: "market",
+            ...typeof input.maxSlippage === "number" ? { maxSlippage: input.maxSlippage } : {}
+          });
+          return { ok: true, ...formatOrder(await order.settled()) };
+        } catch (error) {
+          if (error instanceof PolicyDeniedError) {
+            return {
+              ok: false,
+              refused: true,
+              reason: error.decision.reason,
+              rule: error.decision.rule
+            };
+          }
+          throw error;
+        }
+      }
+    }
+  } : {};
+  return {
+    definitions: [
+      ...walletTools.definitions,
+      ...Object.values(tradingTools).map((tool) => tool.definition)
+    ],
+    async handle(name, input) {
+      const tradingTool = tradingTools[name];
+      if (tradingTool) return tradingTool.run(input ?? {});
+      return walletTools.handle(name, input ?? {});
+    }
+  };
+}
+function formatOrder(result) {
+  return {
+    orderId: result.id,
+    status: result.status,
+    type: result.type,
+    sell: result.sell,
+    buy: result.buy,
+    filled: formatMoney(result.filled),
+    received: formatMoney(result.received),
+    averagePrice: result.averagePrice,
+    slippage: result.slippage,
+    fees: formatMoney(result.fees),
+    ...result.reason ? { reason: result.reason } : {},
+    ...result.decision ? { policyVersion: result.decision.policyVersion } : {}
+  };
+}
+
+// src/server.ts
+function createMcpServer(options) {
+  const tools = buildTools(options);
+  const server2 = new Server(
+    { name: options.name ?? "moneo", version: options.version ?? "0.1.0" },
+    { capabilities: { tools: {} } }
+  );
+  server2.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: tools.definitions.map((d) => ({
+      name: d.name,
+      description: d.description,
+      inputSchema: d.inputSchema
+    }))
+  }));
+  server2.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+      const result = await tools.handle(
+        request.params.name,
+        request.params.arguments ?? {}
+      );
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+        isError: true
+      };
+    }
+  });
+  return server2;
+}
+async function serveStdio(server2) {
+  const transport = new StdioServerTransport();
+  await server2.connect(transport);
+}
+
+// src/cli.ts
+var sandbox = await createSandbox();
+var server = createMcpServer({ ...sandbox, name: "moneo-sandbox" });
+console.error(
+  `[moneo-mcp] sandbox ledger for "${sandbox.wallet.agent}" \u2014 wallet ${sandbox.wallet.address}, policy ${sandbox.guard.policy.version}. Test funds only; nothing here moves real value.`
+);
+await serveStdio(server);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sandbox.ts","../src/server.ts","../src/tools.ts","../src/cli.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { fixedPrices, registerAsset } from \"@moneolabs/core\";\nimport { createGuard, type Guard, type Policy } from \"@moneolabs/guard\";\nimport { createTrading, simulatedVenue, type Trading } from \"@moneolabs/trading\";\nimport { createWallet, localSigner, memoryRail, type Wallet } from \"@moneolabs/wallet\";\n\n/**\n * The zero-config environment `npx @moneolabs/mcp` serves: a funded wallet on\n * the in-memory rail, a deliberately cautious default policy, and a simulated\n * venue quoting a few tokenized equities. Nothing here touches real value —\n * it exists so an agent host can try the whole surface in one command.\n */\nexport interface SandboxOptions {\n  /** Agent identity recorded on every decision. Env: MONEO_AGENT. */\n  agent?: string;\n  /** Starting balance. Env: MONEO_FUNDING. */\n  funding?: string;\n  /** Default asset. Env: MONEO_ASSET. */\n  asset?: string;\n  /** Path to a policy JSON file. Env: MONEO_POLICY. */\n  policyPath?: string;\n}\n\nexport interface Sandbox {\n  wallet: Wallet;\n  guard: Guard;\n  trading: Trading;\n}\n\n// Policy amounts are USD; the guard settles them against the dollar-pegged wallet.\nconst DEFAULT_POLICY: Policy = {\n  perTransaction: { max: \"$500\" },\n  rolling24h: { max: \"$2,000\" },\n  velocity: { max: 20, per: \"1m\" },\n  counterparties: \"allowlist-only\",\n  allow: [\"x402:*\", \"venue:*\", \"vendor:*\"],\n  escalate: { above: \"$1,000\" },\n};\n\n/** Simulated marks, in USDG per share. The venue quotes the inverse. */\nconst SANDBOX_PRICES: Record<string, number> = {\n  AAPLX: 228.41,\n  TSLAX: 312.76,\n  NVDAX: 171.34,\n  SPYX: 563.02,\n};\n\nexport async function createSandbox(options: SandboxOptions = {}): Promise<Sandbox> {\n  const agent = options.agent ?? process.env.MONEO_AGENT ?? \"sandbox-agent\";\n  const funding = options.funding ?? process.env.MONEO_FUNDING ?? \"5,000 USDG\";\n  const asset = options.asset ?? process.env.MONEO_ASSET ?? \"USDG\";\n  const policyPath = options.policyPath ?? process.env.MONEO_POLICY;\n\n  const policy: Policy = policyPath\n    ? (JSON.parse(readFileSync(policyPath, \"utf8\")) as Policy)\n    : DEFAULT_POLICY;\n\n  // The guard prices non-pegged assets in USD to enforce dollar limits, so it\n  // gets the same marks the venue quotes from.\n  const guard = createGuard(policy, { agent, prices: fixedPrices(SANDBOX_PRICES) });\n\n  const wallet = await createWallet({\n    agent,\n    signer: localSigner(),\n    rail: memoryRail(),\n    asset,\n    guard,\n    funding,\n  });\n\n  const prices: Record<string, number> = {};\n  for (const [symbol, usdg] of Object.entries(SANDBOX_PRICES)) {\n    registerAsset({ symbol, decimals: 18 });\n    prices[`${asset}/${symbol}`] = 1 / usdg; // how much of the share one USDG buys\n    prices[`${symbol}/${asset}`] = usdg; // and the way back out\n  }\n\n  const trading = createTrading({\n    agent,\n    guard,\n    quoteAsset: asset,\n    venues: [simulatedVenue({ name: \"sandbox-pool\", prices, feeRate: 0.0005 })],\n  });\n\n  return { wallet, guard, trading };\n}\n","import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { CallToolRequestSchema, ListToolsRequestSchema } from \"@modelcontextprotocol/sdk/types.js\";\nimport { buildTools, type McpToolsOptions } from \"./tools.js\";\n\nexport interface McpServerOptions extends McpToolsOptions {\n  /** Server name reported to the host. */\n  name?: string;\n  version?: string;\n}\n\n/**\n * Wrap a wallet (and optionally a guard and a trading instance) in an MCP\n * server. The transport is yours to choose; `serveStdio` covers the common\n * case of a host that spawns the server as a subprocess.\n */\nexport function createMcpServer(options: McpServerOptions): Server {\n  const tools = buildTools(options);\n  const server = new Server(\n    { name: options.name ?? \"moneo\", version: options.version ?? \"0.1.0\" },\n    { capabilities: { tools: {} } },\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: tools.definitions.map((d) => ({\n      name: d.name,\n      description: d.description,\n      inputSchema: d.inputSchema,\n    })),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    try {\n      const result = await tools.handle(\n        request.params.name,\n        (request.params.arguments ?? {}) as Record<string, unknown>,\n      );\n      return { content: [{ type: \"text\", text: JSON.stringify(result, null, 2) }] };\n    } catch (error) {\n      // Policy refusals never reach here: they come back as ordinary results\n      // with a reason. This path is for genuinely broken calls.\n      const message = error instanceof Error ? error.message : String(error);\n      return {\n        content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n        isError: true,\n      };\n    }\n  });\n\n  return server;\n}\n\n/** Connect a server to stdio and keep the process alive until the host hangs up. */\nexport async function serveStdio(server: Server): Promise<void> {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n","import { formatMoney } from \"@moneolabs/core\";\nimport { PolicyDeniedError, type Guard } from \"@moneolabs/guard\";\nimport type { OrderOptions, OrderResult, Trading } from \"@moneolabs/trading\";\nimport { toolkit, type ToolDefinition, type ToolName, type Wallet } from \"@moneolabs/wallet\";\n\n/**\n * One flat tool surface for an MCP host: the wallet toolkit as-is, plus the\n * trading calls when a trading instance is supplied. Same contract as the\n * toolkit: a refusal is a result with a reason, never an exception, so the\n * model reads why it was stopped instead of retrying blind.\n */\nexport interface McpToolsOptions {\n  wallet: Wallet;\n  guard?: Guard;\n  trading?: Trading;\n  /** Restrict the wallet tools. Trading tools ride on `trading` being set. */\n  include?: readonly ToolName[];\n}\n\nexport interface McpTools {\n  definitions: ToolDefinition[];\n  handle(name: string, input: Record<string, unknown>): Promise<unknown>;\n}\n\nexport function buildTools(options: McpToolsOptions): McpTools {\n  const walletTools = toolkit(options.wallet, {\n    ...(options.guard ? { guard: options.guard } : {}),\n    ...(options.include ? { include: options.include } : {}),\n  });\n\n  const trading = options.trading;\n  const tradingTools: Record<string, { definition: ToolDefinition; run: Handler }> = trading\n    ? {\n        get_quote: {\n          definition: {\n            name: \"get_quote\",\n            description:\n              \"Price a trade across every venue that can fill it, without committing to anything. Returns the best route.\",\n            inputSchema: {\n              type: \"object\",\n              properties: {\n                sell: { type: \"string\", description: 'Asset given up, for example \"USDG\".' },\n                buy: { type: \"string\", description: 'Asset acquired, for example \"AAPLX\".' },\n                notional: {\n                  type: \"string\",\n                  description: 'How much to spend, for example \"300 USDG\".',\n                },\n              },\n              required: [\"sell\", \"buy\", \"notional\"],\n            },\n          },\n          async run(input) {\n            const quote = await trading.quote({\n              sell: String(input.sell),\n              buy: String(input.buy),\n              notional: String(input.notional),\n            });\n            return {\n              quoteId: quote.id,\n              venue: quote.venue,\n              sells: formatMoney(quote.sellAmount),\n              buys: formatMoney(quote.buyAmount),\n              price: quote.price,\n              fee: formatMoney(quote.fee),\n              impact: quote.impact,\n              expiresAt: new Date(quote.expiresAt).toISOString(),\n            };\n          },\n        },\n\n        execute_order: {\n          definition: {\n            name: \"execute_order\",\n            description:\n              \"Quote and execute a trade. Policy runs before anything is signed: a refusal returns the reason and costs nothing. Attach takeProfit and stopLoss to ship the exit with the entry.\",\n            inputSchema: {\n              type: \"object\",\n              properties: {\n                sell: { type: \"string\", description: \"Asset given up.\" },\n                buy: { type: \"string\", description: \"Asset acquired.\" },\n                notional: { type: \"string\", description: 'How much to spend, e.g. \"300 USDG\".' },\n                type: {\n                  type: \"string\",\n                  enum: [\"market\", \"limit\", \"twap\", \"bracket\"],\n                  description: \"Order type. Defaults to market.\",\n                },\n                maxSlippage: {\n                  type: \"number\",\n                  description:\n                    \"Largest acceptable adverse move as a fraction, e.g. 0.003. Exceeding it rejects the order instead of filling it worse.\",\n                },\n                limitPrice: { type: \"number\", description: \"limit: price to rest at.\" },\n                window: {\n                  type: \"string\",\n                  description: 'twap: window to spread across, e.g. \"30m\".',\n                },\n                takeProfit: { type: \"number\", description: \"bracket: exit price above.\" },\n                stopLoss: { type: \"number\", description: \"bracket: exit price below.\" },\n              },\n              required: [\"sell\", \"buy\", \"notional\"],\n            },\n          },\n          async run(input) {\n            const orderOptions: OrderOptions = {\n              ...(input.type ? { type: input.type as OrderOptions[\"type\"] } : {}),\n              ...(typeof input.maxSlippage === \"number\" ? { maxSlippage: input.maxSlippage } : {}),\n              ...(typeof input.limitPrice === \"number\" ? { limitPrice: input.limitPrice } : {}),\n              ...(input.window ? { window: String(input.window) } : {}),\n              ...(typeof input.takeProfit === \"number\" ? { takeProfit: input.takeProfit } : {}),\n              ...(typeof input.stopLoss === \"number\" ? { stopLoss: input.stopLoss } : {}),\n            };\n            try {\n              const quote = await trading.quote({\n                sell: String(input.sell),\n                buy: String(input.buy),\n                notional: String(input.notional),\n              });\n              const order = await trading.execute(quote, orderOptions);\n              return { ok: true, ...formatOrder(await order.settled()) };\n            } catch (error) {\n              if (error instanceof PolicyDeniedError) {\n                return {\n                  ok: false,\n                  refused: true,\n                  reason: error.decision.reason,\n                  rule: error.decision.rule,\n                  hint: \"This limit is set by the wallet owner. Ask them to raise it rather than retrying.\",\n                };\n              }\n              throw error;\n            }\n          },\n        },\n\n        list_positions: {\n          definition: {\n            name: \"list_positions\",\n            description: \"Open positions with cost basis and unrealized P&L at the latest mark.\",\n            inputSchema: { type: \"object\", properties: {} },\n          },\n          async run() {\n            return trading.positions().map((p) => ({\n              asset: p.asset,\n              quantity: formatMoney(p.quantity),\n              averageCost: p.averageCost,\n              costBasis: formatMoney(p.costBasis),\n              marketValue: formatMoney(p.marketValue),\n              unrealized: formatMoney(p.unrealized),\n              realized: formatMoney(p.realized),\n            }));\n          },\n        },\n\n        close_position: {\n          definition: {\n            name: \"close_position\",\n            description:\n              \"Exit a position with the same guarantees the entry had: policy first, slippage bound enforced.\",\n            inputSchema: {\n              type: \"object\",\n              properties: {\n                asset: { type: \"string\", description: \"Asset to close.\" },\n                maxSlippage: {\n                  type: \"number\",\n                  description: \"Largest acceptable adverse move as a fraction.\",\n                },\n              },\n              required: [\"asset\"],\n            },\n          },\n          async run(input) {\n            try {\n              const order = await trading.close(String(input.asset), {\n                type: \"market\",\n                ...(typeof input.maxSlippage === \"number\"\n                  ? { maxSlippage: input.maxSlippage }\n                  : {}),\n              });\n              return { ok: true, ...formatOrder(await order.settled()) };\n            } catch (error) {\n              if (error instanceof PolicyDeniedError) {\n                return {\n                  ok: false,\n                  refused: true,\n                  reason: error.decision.reason,\n                  rule: error.decision.rule,\n                };\n              }\n              throw error;\n            }\n          },\n        },\n      }\n    : {};\n\n  return {\n    definitions: [\n      ...walletTools.definitions,\n      ...Object.values(tradingTools).map((tool) => tool.definition),\n    ],\n    async handle(name, input) {\n      const tradingTool = tradingTools[name];\n      if (tradingTool) return tradingTool.run(input ?? {});\n      return walletTools.handle(name, input ?? {});\n    },\n  };\n}\n\nfunction formatOrder(result: OrderResult) {\n  return {\n    orderId: result.id,\n    status: result.status,\n    type: result.type,\n    sell: result.sell,\n    buy: result.buy,\n    filled: formatMoney(result.filled),\n    received: formatMoney(result.received),\n    averagePrice: result.averagePrice,\n    slippage: result.slippage,\n    fees: formatMoney(result.fees),\n    ...(result.reason ? { reason: result.reason } : {}),\n    ...(result.decision ? { policyVersion: result.decision.policyVersion } : {}),\n  };\n}\n\ntype Handler = (input: Record<string, unknown>) => Promise<unknown>;\n","#!/usr/bin/env node\n/**\n * `npx @moneolabs/mcp` — serve the sandbox over stdio.\n *\n * Everything runs in this process against test funds. Configuration is\n * environment variables, because MCP host configs pass env, not flags:\n *\n *   MONEO_AGENT    agent identity on every decision   (default sandbox-agent)\n *   MONEO_FUNDING  starting balance                   (default \"5,000 USDG\")\n *   MONEO_ASSET    default asset                      (default USDG)\n *   MONEO_POLICY   path to a policy JSON file         (default: cautious built-in)\n *\n * Logs go to stderr. Stdout belongs to the protocol.\n */\nimport { createSandbox } from \"./sandbox.js\";\nimport { createMcpServer, serveStdio } from \"./server.js\";\n\nconst sandbox = await createSandbox();\nconst server = createMcpServer({ ...sandbox, name: \"moneo-sandbox\" });\n\nconsole.error(\n  `[moneo-mcp] sandbox ledger for \"${sandbox.wallet.agent}\" — ` +\n    `wallet ${sandbox.wallet.address}, policy ${sandbox.guard.policy.version}. ` +\n    \"Test funds only; nothing here moves real value.\",\n);\n\nawait serveStdio(server);\n"],"mappings":"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","names":["server"]}