@getpalmos/mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,23 +1,32 @@
 # @getpalmos/mcp
 
-Model Context Protocol (MCP) server for PalmOS. It gives Claude Code, Codex, and
-any other MCP-capable agent a set of **governed payment tools** — the agent can
-discover paid services, check policy, and request payments, while PalmOS enforces
-budget, allowlist, approval, settlement, and audit rules server-side. The agent
-never holds a wallet key.
+Model Context Protocol (MCP) server for PalmOS. It gives Claude Code, Codex, and any other
+MCP-capable agent PalmOS's **governed agent-wallet tools** — Byreal swaps, concentrated (CLMM)
+liquidity, pool and position discovery, wallet context, and policy checks — while PalmOS enforces
+policy, custody, settlement, and an on-chain audit trail server-side. The agent never holds a key.
+
+The bridge is generic: it exposes whatever governed tools your PalmOS backend offers (read live from
+`/api/sdk/v1/tools`), so new skills appear automatically without upgrading this package.
 
 ## Tools
 
+Exact tools depend on your backend (the server lists them on connect). A typical Byreal-enabled
+PalmOS backend exposes:
+
 | Tool | Purpose |
 | --- | --- |
-| `palmos_list_services` | List the paid services this agent is allowed to call. |
-| `palmos_check_policy` | Preview whether a payment would be allowed / approval-gated / denied (no spend). |
-| `palmos_get_agent_status` | Report the agent's PalmOS identity, trust tier, and settlement mode. |
-| `palmos_pay` | Execute a governed paid-service call. |
-
-`palmos_pay` is the only tool that can move money, and every call is still
-gated by PalmOS policy: small allowed payments execute, higher-value ones become
-approval-pending for an operator, and disallowed services are blocked.
+| `get_wallet_context` | The agent's balances, portfolio, and the policy controls it must act within. |
+| `list_byreal_pools` | Discover Byreal CLMM pools — ids, token mints, live price, and which are policy-allowed. |
+| `get_byreal_quote` | A live Byreal swap quote (read-only). |
+| `request_asset_swap` | A governed Byreal swap (policy-checked, vault-signed, settled). |
+| `list_byreal_positions` | The agent's CLMM liquidity positions. |
+| `request_liquidity_action` | Governed CLMM liquidity: open / increase / decrease / close. Pass `rangePercent` for an automatic ± range. |
+| `check_policy` | Preview whether an action is allowed / approval-gated / denied (no spend). |
+| `get_agent_status` | The agent's PalmOS identity, trust tier, and settlement mode. |
+
+Every governed action is gated by PalmOS policy: within the auto-approve threshold it settles, a
+larger-but-allowed action becomes approval-pending for an operator, and an off-policy action is
+blocked. The agent reads the governed outcome and reasons about it.
 
 ## Prerequisites
 
@@ -89,12 +98,12 @@ Build it first with `npm run build` (from `packages/mcp`) or
 
 Once configured, ask the agent naturally, e.g.:
 
-> "List my PalmOS services, check the policy for `local.pusd.spot_price`, then
-> pay for a BTC/USD spot price."
+> "Show me the SOL/USDC Byreal pools I'm allowed to use, then open a 0.05 USDC liquidity
+> position with a ±12% range."
 
-The agent will call `palmos_list_services` → `palmos_check_policy` → `palmos_pay`.
-PalmOS records every outcome (executed, approval-pending, blocked) with an audit
-trail in the dashboard.
+The agent calls `list_byreal_pools` → `request_liquidity_action`. PalmOS checks the policy, the OWS
+vault signs, the position settles on Byreal, and the decision is logged on-chain — every outcome
+(executed, approval-pending, blocked) shows up in the dashboard with an audit trail.
 
 ## Token storage
 

package/dist/index.js

@@ -1,123 +1,123 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * @getpalmos/mcp — a Model Context Protocol server that exposes PalmOS's governed agent tools to any
+ * MCP client (Claude Code, Codex, …). It reads the live tool catalog from your PalmOS backend
+ * (`GET /api/sdk/v1/tools`) and proxies each call to `POST /api/sdk/v1/tools/:toolName` with your
+ * agent's bearer token — so every governed skill is available: Byreal swaps, CLMM liquidity
+ * (open/increase/decrease/close), pool + position discovery, wallet context, policy checks, and
+ * paid-service calls. New backend tools appear automatically; nothing here is hardcoded.
+ *
+ * The agent reaches PalmOS *only* through this bridge; PalmOS governs every call (policy gate, OWS
+ * vault custody, on-chain decision log). The bridge holds no keys and cannot bypass policy — a denied
+ * action comes back as an error the agent reads and reasons about.
+ *
+ * Run:
+ *   npx @getpalmos/mcp
+ *
+ * Or wire it into an MCP client (e.g. Claude Code .mcp.json):
+ *   {
+ *     "command": "npx",
+ *     "args": ["-y", "@getpalmos/mcp"],
+ *     "env": { "PALMOS_AGENT_TOKEN": "palmos_...", "PALMOS_API_URL": "https://api.getpalmos.xyz" }
+ *   }
+ *
+ * Env (also auto-loaded from a local .env):
+ *   PALMOS_AGENT_TOKEN  (required) — an issued palmos_... agent credential from the dashboard.
+ *   PALMOS_API_URL      (optional) — your PalmOS backend; default https://api.getpalmos.xyz.
+ *   PALMOS_MCP_TOOLS    (optional) — comma-separated allowlist of tool names to expose.
+ *
+ * NOTE: stdout is the MCP JSON-RPC channel — all logging goes to stderr.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-import { PalmosAgentClient, PalmosAgentClientError } from '@getpalmos/agent';
-// Lazily build the client so the server can start and advertise its tools even
-// when no credential is set yet. Tool *calls* still require PALMOS_AGENT_TOKEN.
-let client;
-function getClient() {
-    if (client) {
-        return client;
-    }
-    const token = process.env.PALMOS_AGENT_TOKEN?.trim();
-    if (!token) {
-        throw new Error('Set PALMOS_AGENT_TOKEN to an issued palmos_... SDK credential (from the PalmOS dashboard).');
-    }
-    client = new PalmosAgentClient({
-        baseUrl: process.env.PALMOS_API_URL?.trim(),
-        token,
-    });
-    return client;
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// Pick up a local .env (PALMOS_AGENT_TOKEN, PALMOS_API_URL) when launched by an MCP client.
+try {
+    ;
+    process.loadEnvFile?.();
 }
-function ok(data) {
-    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+catch {
+    // no .env — rely on the ambient environment
 }
-function fail(error) {
-    const message = error instanceof PalmosAgentClientError
-        ? `PalmOS API error ${error.status}: ${error.message}`
-        : error instanceof Error
-            ? error.message
-            : String(error);
-    return { isError: true, content: [{ type: 'text', text: message }] };
+const DEFAULT_API = 'https://api.getpalmos.xyz';
+const API = (process.env.PALMOS_API_URL ?? DEFAULT_API).replace(/\/$/, '');
+const TOKEN = process.env.PALMOS_AGENT_TOKEN?.trim();
+const ALLOWLIST = (process.env.PALMOS_MCP_TOOLS ?? '')
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+const log = (...args) => console.error('[palmos-mcp]', ...args);
+if (!TOKEN) {
+    log('FATAL: set PALMOS_AGENT_TOKEN to an issued palmos_... agent credential (from the PalmOS dashboard).');
+    process.exit(1);
 }
-const server = new McpServer({ name: 'palmos', version: '0.1.0' });
-server.registerTool('palmos_list_services', {
-    title: 'List PalmOS paid services',
-    description: 'List the paid services this PalmOS agent is allowed to call, with vendor, settlement asset, expected amount, payment rail, and whether each is currently allowed by policy. Call this first to discover valid serviceId values.',
-    inputSchema: {},
-}, async () => {
-    try {
-        return ok(await getClient().listServices());
-    }
-    catch (error) {
-        return fail(error);
-    }
-});
-server.registerTool('palmos_get_agent_status', {
-    title: 'Get PalmOS agent status',
-    description: "Return this agent's PalmOS identity and posture: agent and credential status, trust tier, settlement mode, and wallet state.",
-    inputSchema: {},
-}, async () => {
-    try {
-        return ok(await getClient().getAgentStatus());
-    }
-    catch (error) {
-        return fail(error);
-    }
-});
-server.registerTool('palmos_check_policy', {
-    title: 'Check PalmOS payment policy',
-    description: 'Preview whether a payment for a service (and optional amount) would be allowed, approval-gated, or denied — WITHOUT spending anything. Use this before palmos_pay to avoid surprises.',
-    inputSchema: {
-        serviceId: z
-            .string()
-            .describe('PalmOS service id, e.g. local.pusd.spot_price'),
-        amount: z
-            .string()
-            .optional()
-            .describe('Optional amount override as a decimal string, e.g. "0.25".'),
-    },
-}, async ({ serviceId, amount }) => {
+const authHeaders = {
+    Authorization: `Bearer ${TOKEN}`,
+    'Content-Type': 'application/json',
+};
+async function fetchTools() {
+    const res = await fetch(`${API}/api/sdk/v1/tools`, { headers: authHeaders });
+    if (!res.ok)
+        throw new Error(`GET /api/sdk/v1/tools → ${res.status}`);
+    const body = (await res.json());
+    let tools = body.tools ?? [];
+    if (ALLOWLIST.length)
+        tools = tools.filter((t) => ALLOWLIST.includes(t.name));
+    return tools;
+}
+const server = new Server({ name: 'palmos', version: '0.2.0' }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => {
     try {
-        return ok(await getClient().checkPolicy({ serviceId, amount }));
+        const tools = await fetchTools();
+        log(`exposing ${tools.length} governed tools: ${tools.map((t) => t.name).join(', ')}`);
+        return {
+            tools: tools.map((t) => ({
+                name: t.name,
+                description: t.description ?? '',
+                inputSchema: t.inputSchema ?? { type: 'object' },
+            })),
+        };
     }
     catch (error) {
-        return fail(error);
+        log('list-tools failed (is PALMOS_API_URL reachable + the token valid?):', error.message);
+        return { tools: [] };
     }
 });
-server.registerTool('palmos_pay', {
-    title: 'Execute a governed PalmOS payment',
-    description: 'Request a governed paid-service call. PalmOS enforces policy, session budget, vendor allowlist, and approval gates server-side: small allowed payments execute immediately, higher-value ones become approval-pending for an operator, and disallowed services/vendors are blocked. The agent never holds wallet keys. Returns the execution record; check result.kind (executed | approval_pending | waiting_for_execution | blocked | execution_failed). Pass a stable idempotencyKey derived from a job/run id so retries do not double-pay.',
-    inputSchema: {
-        serviceId: z.string().describe('PalmOS service id to pay for.'),
-        request: z
-            .record(z.string(), z.unknown())
-            .optional()
-            .describe('Service request payload, e.g. { "base": "BTC", "quote": "USD" }.'),
-        amount: z
-            .string()
-            .optional()
-            .describe('Optional amount override as a decimal string.'),
-        note: z
-            .string()
-            .optional()
-            .describe('Optional human-readable note stored on the paid-call record.'),
-        idempotencyKey: z
-            .string()
-            .optional()
-            .describe('Stable key from a job/run id so retries are not double-charged.'),
-        privacy: z
-            .enum(['default', 'required'])
-            .optional()
-            .describe('Set "required" to force private (Umbra) settlement; fails closed if no private route is configured.'),
-    },
-}, async (input) => {
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const name = req.params.name;
+    const args = (req.params.arguments ?? {});
     try {
-        return ok(await getClient().pay(input));
+        const res = await fetch(`${API}/api/sdk/v1/tools/${encodeURIComponent(name)}`, {
+            method: 'POST',
+            headers: authHeaders,
+            body: JSON.stringify(args),
+        });
+        const raw = await res.text();
+        let text = raw;
+        try {
+            text = JSON.stringify(JSON.parse(raw), null, 2);
+        }
+        catch {
+            // non-JSON body — return as-is
+        }
+        // A policy denial (HTTP 403) is a legitimate governed outcome: surface it as an error the agent
+        // reads and reasons about, rather than a silent success.
+        return { content: [{ type: 'text', text }], isError: !res.ok };
     }
     catch (error) {
-        return fail(error);
+        return {
+            content: [{ type: 'text', text: `PalmOS MCP bridge call failed: ${error.message}` }],
+            isError: true,
+        };
     }
 });
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    // stdout is the JSON-RPC channel; log to stderr only.
-    console.error('[palmos-mcp] PalmOS MCP server ready on stdio.');
+    log(`connected — proxying governed PalmOS tools from ${API}`);
 }
 main().catch((error) => {
-    console.error('[palmos-mcp] fatal:', error instanceof Error ? error.message : error);
+    log('fatal:', error instanceof Error ? error.message : error);
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@getpalmos/mcp",
-  "version": "0.1.0",
-  "description": "Model Context Protocol server for PalmOS. Gives Claude Code, Codex, and other MCP agents governed PUSD payment tools.",
+  "version": "0.2.0",
+  "description": "Model Context Protocol server for PalmOS — governed Byreal swaps, CLMM liquidity, and agent-wallet actions for Claude Code, Codex, and other MCP clients.",
   "type": "module",
   "license": "MIT",
   "author": "PalmOS",
@@ -44,16 +44,16 @@
     "mcp",
     "model-context-protocol",
     "agent",
-    "pusd",
+    "byreal",
     "solana",
-    "payments",
+    "defi",
+    "liquidity",
+    "swap",
     "claude",
     "codex"
   ],
   "dependencies": {
-    "@getpalmos/agent": "^0.1.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "3.25.76"
+    "@modelcontextprotocol/sdk": "^1.29.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.2"