@noelclaw/mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 noelclaw
+
+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,246 @@
+# @noelclaw/mcp
+
+[![npm version](https://img.shields.io/npm/v/@noelclaw/mcp.svg)](https://www.npmjs.com/package/@noelclaw/mcp)
+
+Noelclaw as an MCP skill — persistent memory, multi-agent coordination, scenario simulation, DeFi execution, and Sentinel-gated playbooks. Works with Claude, Cursor, Hermes, Windsurf, and any MCP-compatible client.
+
+```bash
+npx @noelclaw/mcp@latest
+```
+
+---
+
+## Quick Install
+
+### Claude Code
+```bash
+claude mcp add noelclaw -- npx @noelclaw/mcp@latest
+```
+
+Set your API key:
+```bash
+claude mcp add noelclaw -e NOELCLAW_API_KEY=noel_... -- npx @noelclaw/mcp@latest
+```
+
+### Claude Desktop
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "noelclaw": {
+      "command": "npx",
+      "args": ["@noelclaw/mcp@latest"],
+      "env": {
+        "NOELCLAW_API_KEY": "noel_..."
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+```json
+{
+  "mcpServers": {
+    "noelclaw": {
+      "command": "npx",
+      "args": ["@noelclaw/mcp@latest"],
+      "env": {
+        "NOELCLAW_API_KEY": "noel_..."
+      }
+    }
+  }
+}
+```
+
+### Hermes
+```yaml
+mcp_servers:
+  noelclaw:
+    command: npx
+    args:
+      - "@noelclaw/mcp@latest"
+    env:
+      NOELCLAW_API_KEY: "noel_..."
+```
+
+---
+
+## Authentication
+
+Get a key instantly — no signup:
+
+```bash
+curl -X POST https://api.noelclaw.com/auth/key
+# → { "apiKey": "noel_..." }
+```
+
+Set `NOELCLAW_API_KEY` in your MCP config. That's it.
+
+---
+
+## Tools
+
+### Research & AI
+
+| Tool | Description |
+|------|-------------|
+| `research` | Deep research via Bankr (real-time). Returns overview, key findings, market impact, sentiment |
+| `ask_noel` | Ask Noel AI for analysis, trade ideas, and research |
+| `humanize_text` | Remove AI tells from text — makes output sound natural and human-written |
+
+### Noel-Vault
+
+> Persistent memory across sessions. Save findings, recall by key, search full-text. Every save auto-versions.
+
+| Tool | Description |
+|------|-------------|
+| `vault_save` | Save any content — research, execution logs, workflows, prompts, files |
+| `vault_read` | Read an entry by key |
+| `vault_list` | List all entries with type, title, version, last updated |
+| `vault_search` | Full-text search across all content |
+| `vault_history` | Version history with commit messages |
+| `vault_diff` | Line-by-line diff between two versions |
+| `vault_export` | Export as markdown or JSON |
+
+### Noel-Swarm
+
+> Shared memory bus for multi-agent coordination. All agents read/write the same store with freshness tracking.
+
+| Tool | Description |
+|------|-------------|
+| `start_swarm` | Start a swarm session |
+| `stop_swarm` | Stop the active session |
+| `get_swarm_status` | Session state, memory snapshot, execution scores |
+| `write_swarm_memory` | Write a key-value entry with optional TTL |
+| `get_swarm_memory` | Read by key — returns value + freshness metadata |
+| `get_execution_scores` | Per-agent, per-skill scores |
+
+### MiroShark
+
+> Scenario simulation engine — drop in any scenario and get back strategic insights from a network of AI agents reacting hour by hour. Requires `MIROSHARK_URL` + `MIROSHARK_ADMIN_TOKEN`.
+
+| Tool | Description |
+|------|-------------|
+| `miroshark_simulate` | Run a multi-agent simulation from a plain-English scenario. Returns a simulation ID |
+| `miroshark_status` | Poll simulation results by ID — surfaces insights and consensus when complete |
+
+### Wallet & DeFi `beta`
+
+> On-chain operations on Base mainnet. Transactions are built for client-side signing — no private key ever leaves your machine.
+
+| Tool | Description |
+|------|-------------|
+| `get_wallet_address` | Show your local MCP wallet address |
+| `get_portfolio` | Full token portfolio with ETH and ERC-20 balances and USD values |
+| `swap_tokens` | Swap tokens on Base mainnet |
+| `send_token` | Send ETH or any ERC-20 to any address |
+
+### Automations `beta`
+
+| Tool | Description |
+|------|-------------|
+| `create_automation` | Create an automation in plain English — DCA, price alerts, conditional buys/sells |
+| `list_automations` | List all automations with status and next scheduled run |
+| `pause_automation` | Pause or resume an automation |
+| `delete_automation` | Permanently delete an automation |
+
+### Noel Framework `beta`
+
+> Sentinel-gated agent execution. Define what your AI can and can't do — before it runs. Every action checked against 5 mechanical rules before execution.
+
+| Tool | Description |
+|------|-------------|
+| `create_task_packet` | Convert plain-English intent into a structured task scope with permissions and constraints |
+| `list_task_packets` | List all task packets |
+| `list_playbooks` | List available playbooks |
+| `run_playbook` | Execute a Sentinel-gated playbook — halts if any step is blocked |
+| `get_noel_ledger` | Full audit trail of every Sentinel decision |
+| `get_sentinel_rules` | Exact rules per agent role |
+
+### Notifications
+
+| Tool | Description |
+|------|-------------|
+| `set_telegram` | Connect Telegram for push notifications |
+
+---
+
+## Environment Variables
+
+### Required
+
+| Var | Description |
+|-----|-------------|
+| `NOELCLAW_API_KEY` | Your API key (`noel_...`) — get one at `POST https://api.noelclaw.com/auth/key` |
+
+### MiroShark (optional)
+
+| Var | Description |
+|-----|-------------|
+| `MIROSHARK_URL` | URL of your deployed MiroShark instance |
+| `MIROSHARK_ADMIN_TOKEN` | Admin token set on your MiroShark deployment |
+
+### BYOK (optional)
+
+| Var | Used for |
+|-----|---------|
+| `BANKR_API_KEY` | Bankr Agent — research, DeFi |
+| `TELEGRAM_BOT_TOKEN` | Your own Telegram bot |
+| `TELEGRAM_CHAT_ID` | Your Telegram chat ID |
+| `ALCHEMY_API_KEY` | Faster Base RPC for swaps and portfolio |
+
+---
+
+## Usage Examples
+
+```
+# Research anything
+research(query: "What is happening with the Base ecosystem this week?")
+ask_noel(question: "What are the risks of holding ETH through a Fed meeting?")
+
+# Save findings to vault
+vault_save(type: "research", key: "research/base-may-2026", title: "Base Ecosystem", content: "...")
+vault_search(query: "Base ecosystem")
+
+# Coordinate agents via swarm
+start_swarm
+write_swarm_memory(agentId: "analyst", key: "research/btc", value: "bullish", ttlSeconds: 3600)
+get_swarm_memory(key: "research/btc")
+
+# Run a MiroShark simulation
+miroshark_simulate(scenario: "What happens if a major L1 announces a 50% fee reduction?")
+miroshark_status(simulation_id: "sim_abc123")
+
+# Clean up AI-generated text
+humanize_text(text: "Certainly! I'd be happy to assist you with...")
+
+# DeFi (beta)
+get_portfolio
+swap_tokens(fromToken: "ETH", toToken: "USDC", amount: "0.01")
+
+# Sentinel-gated execution (beta)
+create_task_packet(task: "Monitor portfolio, max $0 spend, read only")
+run_playbook(playbook_name: "Daily Market Scan")
+get_noel_ledger
+```
+
+---
+
+## Troubleshooting
+
+| Error | Fix |
+|-------|-----|
+| Tools not appearing | Restart your MCP client after adding the config |
+| `401 Unauthorized` | Check `NOELCLAW_API_KEY` is set — get one at `POST https://api.noelclaw.com/auth/key` |
+| `miroshark_simulate` error | Set `MIROSHARK_URL` and `MIROSHARK_ADMIN_TOKEN` |
+| Server starts but no response | Expected — server waits for MCP stdin, not HTTP |
+
+---
+
+## Links
+
+- npm: [npmjs.com/package/@noelclaw/mcp](https://npmjs.com/package/@noelclaw/mcp)
+- GitHub: [github.com/noelclaw/research](https://github.com/noelclaw/mcp)
+- Platform: [noelclaw.com](https://noelclaw.com)

package/dist/convex.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentRequiredError = void 0;
+exports.buildPaymentHeader = buildPaymentHeader;
+exports.callConvex = callConvex;
+exports.notifyTelegram = notifyTelegram;
+const wallet_js_1 = require("./wallet.js");
+const CONVEX_SITE = process.env.NOELCLAW_CONVEX_URL ?? "https://api.noelclaw.com";
+const RETRY_STATUSES = new Set([429, 500, 502, 503, 504]);
+const RETRY_DELAYS = [500, 1000, 2000];
+class PaymentRequiredError extends Error {
+    constructor(details) {
+        super("Payment required");
+        this.name = "PaymentRequiredError";
+        this.details = details;
+    }
+}
+exports.PaymentRequiredError = PaymentRequiredError;
+function buildPaymentHeader(txHash, requestId) {
+    return Buffer.from(`${txHash}:${requestId}`).toString("base64");
+}
+async function attemptConvex(url, method, headers, body) {
+    return fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+        signal: AbortSignal.timeout(30000),
+    });
+}
+async function callConvex(path, method, body, toolName = "unknown") {
+    const url = `${CONVEX_SITE}${path}`;
+    const headers = { "Content-Type": "application/json" };
+    const apiKey = process.env.NOELCLAW_API_KEY;
+    const sessionToken = process.env.NOELCLAW_SESSION_TOKEN;
+    const authHeader = apiKey
+        ? `Bearer ${apiKey}`
+        : sessionToken
+            ? `Bearer ${sessionToken}`
+            : null;
+    if (authHeader) {
+        headers["Authorization"] = authHeader;
+    }
+    else {
+        try {
+            const { address, signature, timestamp } = await (0, wallet_js_1.signRequest)(toolName);
+            headers["X-Wallet-Address"] = address;
+            headers["X-Wallet-Signature"] = signature;
+            headers["X-Wallet-Timestamp"] = timestamp;
+        }
+        catch {
+            // continue without wallet headers — server will respond with 401/402
+        }
+    }
+    const paymentHeader = process.env.NOELCLAW_PAYMENT_HEADER;
+    if (paymentHeader)
+        headers["X-Payment"] = paymentHeader;
+    // BYOK headers
+    if (process.env.GROK_API_KEY)
+        headers["X-User-Grok-Key"] = process.env.GROK_API_KEY;
+    if (process.env.BANKR_API_KEY)
+        headers["X-User-Bankr-Key"] = process.env.BANKR_API_KEY;
+    if (process.env.TELEGRAM_BOT_TOKEN)
+        headers["X-User-Telegram-Token"] = process.env.TELEGRAM_BOT_TOKEN;
+    if (process.env.TELEGRAM_CHAT_ID)
+        headers["X-User-Telegram-Chat"] = process.env.TELEGRAM_CHAT_ID;
+    let lastError = null;
+    for (let attempt = 0; attempt < RETRY_DELAYS.length; attempt++) {
+        if (attempt > 0) {
+            await new Promise((r) => setTimeout(r, RETRY_DELAYS[attempt - 1]));
+        }
+        let res;
+        try {
+            res = await attemptConvex(url, method, headers, body);
+        }
+        catch (err) {
+            lastError = err;
+            continue;
+        }
+        if (res.status === 402) {
+            const b = await res.json().catch(() => ({}));
+            throw new PaymentRequiredError(b);
+        }
+        if (res.status === 401) {
+            const b = await res.json().catch(() => ({}));
+            throw new Error(`🔑 ${b.message || "Authentication required"}\n\n` +
+                `→ Get your API key: ${b.url || "https://noelclaw.com"}\n\n` +
+                `Hint: ${b.hint || "Set NOELCLAW_API_KEY=noel_sk_xxx in your MCP config"}\n\n` +
+                `${b.alternative ? `Alternative: ${b.alternative}` : ""}`);
+        }
+        if (RETRY_STATUSES.has(res.status) && attempt < RETRY_DELAYS.length) {
+            lastError = new Error(`Noelclaw API error: ${res.status}`);
+            continue;
+        }
+        if (!res.ok)
+            throw new Error(`Noelclaw API error: ${res.status} ${await res.text()}`);
+        return res.json();
+    }
+    throw lastError ?? new Error("Request failed after retries");
+}
+async function notifyTelegram(userId, message) {
+    try {
+        return await callConvex("/user/telegram/notify", "POST", { userId, message }, "set_telegram");
+    }
+    catch (error) {
+        return { sent: false, reason: error.message ?? String(error) };
+    }
+}

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = require("./server.js");
+const wallet_js_1 = require("./wallet.js");
+const BANNER = `
+\x1b[36m
+  ███╗   ██╗ ██████╗ ███████╗██╗      ██████╗██╗      █████╗ ██╗    ██╗
+  ████╗  ██║██╔═══██╗██╔════╝██║     ██╔════╝██║     ██╔══██╗██║    ██║
+  ██╔██╗ ██║██║   ██║█████╗  ██║     ██║     ██║     ███████║██║ █╗ ██║
+  ██║╚██╗██║██║   ██║██╔══╝  ██║     ██║     ██║     ██╔══██║██║███╗██║
+  ██║ ╚████║╚██████╔╝███████╗███████╗╚██████╗███████╗██║  ██║╚███╔███╔╝
+  ╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚══════╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝
+\x1b[0m  \x1b[90mcrypto AI · MCP · DeFi · research · swarm\x1b[0m
+`;
+async function main() {
+    console.error(BANNER);
+    await (0, server_js_1.startServer)();
+    try {
+        const wallet = await (0, wallet_js_1.getOrCreateWallet)();
+        console.error(`\x1b[36m  ◆ wallet\x1b[0m  ${wallet.address}`);
+        console.error(`\x1b[36m  ◆ status\x1b[0m  ready · 46 tools loaded\n`);
+    }
+    catch (err) {
+        console.error(`[noelclaw] wallet init failed: ${err}`);
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/server.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.server = exports.ALL_TOOLS = void 0;
+exports.startServer = startServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const convex_js_1 = require("./convex.js");
+const market_js_1 = require("./tools/market.js");
+const research_js_1 = require("./tools/research.js");
+const defi_js_1 = require("./tools/defi.js");
+const automation_js_1 = require("./tools/automation.js");
+const swarm_js_1 = require("./tools/swarm.js");
+const insight_js_1 = require("./tools/insight.js");
+const framework_js_1 = require("./tools/framework.js");
+const wallet_js_1 = require("./tools/wallet.js");
+const news_js_1 = require("./tools/news.js");
+const vault_js_1 = require("./tools/vault.js");
+const twitter_js_1 = require("./tools/twitter.js");
+const miroshark_js_1 = require("./tools/miroshark.js");
+const humanizer_js_1 = require("./tools/humanizer.js");
+const PRIVATE_KEY_RESPONSE = {
+    content: [{
+            type: "text",
+            text: "I don't have access to your private key. Your wallet is secured by Noelclaw's encrypted vault. Only you can manage it at noelclaw.xyz",
+        }],
+};
+function containsSensitiveRequest(args) {
+    const text = JSON.stringify(args ?? "").toLowerCase();
+    return (text.includes("private key") ||
+        text.includes("seed phrase") ||
+        text.includes("mnemonic") ||
+        text.includes("privatekey"));
+}
+exports.ALL_TOOLS = [
+    ...market_js_1.MARKET_TOOLS, // 6 — market data, signals, whale alerts, recap
+    ...news_js_1.NEWS_TOOLS, // 2 — crypto news digest, manual signal gen
+    ...research_js_1.RESEARCH_TOOLS, // 1 — deep research
+    ...insight_js_1.INSIGHT_TOOLS, // 2 — get_insight, ask_noel
+    ...defi_js_1.DEFI_TOOLS, // 6 — portfolio, swap, send, deploy, claim, mint
+    ...automation_js_1.AUTOMATION_TOOLS, // 4 — create, list, pause, delete
+    ...swarm_js_1.SWARM_TOOLS, // 6 — start, stop, status, memory, scores
+    ...framework_js_1.FRAMEWORK_TOOLS, // 6 — task packets, playbooks, sentinel, ledger
+    ...vault_js_1.VAULT_TOOLS, // 7 — save, read, list, search, history, diff, export
+    ...wallet_js_1.WALLET_TOOLS, // 2 — wallet address, telegram connect
+    ...twitter_js_1.TWITTER_TOOLS, // 1 — post tweet
+    ...miroshark_js_1.MIROSHARK_TOOLS, // 2 — simulate, status
+    ...humanizer_js_1.HUMANIZER_TOOLS, // 1 — humanize_text
+    // total: 46
+];
+exports.server = new index_js_1.Server({ name: "noelclaw", version: "2.1.0" }, { capabilities: { tools: {} } });
+exports.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools: exports.ALL_TOOLS }));
+exports.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (containsSensitiveRequest(args))
+        return PRIVATE_KEY_RESPONSE;
+    try {
+        const result = await (0, market_js_1.handleMarketTool)(name, args) ??
+            await (0, news_js_1.handleNewsTool)(name, args) ??
+            await (0, research_js_1.handleResearchTool)(name, args) ??
+            await (0, defi_js_1.handleDefiTool)(name, args) ??
+            await (0, automation_js_1.handleAutomationTool)(name, args) ??
+            await (0, swarm_js_1.handleSwarmTool)(name, args) ??
+            await (0, framework_js_1.handleFrameworkTool)(name, args) ??
+            await (0, vault_js_1.handleVaultTool)(name, args) ??
+            await (0, wallet_js_1.handleWalletTool)(name, args) ??
+            await (0, insight_js_1.handleInsightTool)(name, args) ??
+            await (0, twitter_js_1.handleTwitterTool)(name, args) ??
+            await (0, miroshark_js_1.handleMirosharkTool)(name, args) ??
+            await (0, humanizer_js_1.handleHumanizerTool)(name, args);
+        if (result)
+            return result;
+        return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+    }
+    catch (err) {
+        if (err instanceof convex_js_1.PaymentRequiredError) {
+            const d = err.details?.paymentDetails;
+            const lines = [
+                "⚠️ **Payment Required**", "",
+                "This tool requires a USDC micropayment on Base mainnet.",
+                ...(d ? [
+                    ``, `Amount: **${d.amount} USDC**`, `To: \`${d.address}\``, `Request ID: \`${d.requestId}\``, ``,
+                    "**To pay:**",
+                    `1. Send ${d.amount} USDC to \`${d.address}\` on Base mainnet`,
+                    `2. Copy the transaction hash`,
+                    `3. Set env var: \`NOELCLAW_PAYMENT_HEADER=${(0, convex_js_1.buildPaymentHeader)("<txHash>", d.requestId)}\``,
+                    `   (replace \`<txHash>\` with the actual transaction hash)`,
+                    `4. Retry the tool call`, ``,
+                    "**Or bypass with a session token:**",
+                    "Set `NOELCLAW_SESSION_TOKEN` with your Noelclaw session token from noelclaw.xyz",
+                ] : []),
+            ];
+            return { content: [{ type: "text", text: lines.join("\n") }], isError: true };
+        }
+        return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+    }
+});
+async function startServer() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await exports.server.connect(transport);
+}

package/dist/tools/automation.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTOMATION_TOOLS = void 0;
+exports.handleAutomationTool = handleAutomationTool;
+const zod_1 = require("zod");
+const convex_js_1 = require("../convex.js");
+exports.AUTOMATION_TOOLS = [
+    {
+        name: "create_automation",
+        description: "Create an automation in plain English. Supports DCA, price alerts, conditional buys/sells, and recurring market updates.",
+        inputSchema: {
+            type: "object",
+            properties: { rawInput: { type: "string", description: "Plain English description of the automation" } },
+            required: ["rawInput"],
+        },
+    },
+    {
+        name: "list_automations",
+        description: "List all your automations — active, paused, and completed — with status, run counts, and next scheduled run.",
+        inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+        name: "pause_automation",
+        description: "Pause or resume an automation by ID.",
+        inputSchema: {
+            type: "object",
+            properties: { automationId: { type: "string", description: "Automation ID (from list_automations)" } },
+            required: ["automationId"],
+        },
+    },
+    {
+        name: "delete_automation",
+        description: "Permanently delete an automation. Cannot be undone.",
+        inputSchema: {
+            type: "object",
+            properties: { automationId: { type: "string", description: "Automation ID (from list_automations)" } },
+            required: ["automationId"],
+        },
+    },
+];
+const CreateAutomationSchema = zod_1.z.object({ rawInput: zod_1.z.string().min(1) });
+const AutomationIdSchema = zod_1.z.object({ automationId: zod_1.z.string().min(1) });
+async function handleAutomationTool(name, args) {
+    switch (name) {
+        case "create_automation": {
+            const parsed = CreateAutomationSchema.safeParse(args);
+            if (!parsed.success)
+                return { content: [{ type: "text", text: `Invalid input: rawInput ${parsed.error.issues[0].message}` }], isError: true };
+            const data = await (0, convex_js_1.callConvex)("/automations/create", "POST", { rawInput: parsed.data.rawInput }, "create_automation");
+            if (!data.success)
+                return { content: [{ type: "text", text: `Failed: ${data.error}` }], isError: true };
+            const triggerLabel = {
+                schedule: "⏰ Schedule", price_drop_pct: "📉 Price Drop %", price_rise_pct: "📈 Price Rise %",
+                price_below: "⬇️ Price Below", price_above: "⬆️ Price Above",
+                dominance_below: "📊 Dominance Below", dominance_above: "📊 Dominance Above",
+            };
+            const actionLabel = { swap: "💱 Swap", send: "📤 Send", alert: "🔔 Alert" };
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `✅ **Automation Created**`, ``,
+                            `**Name:** ${data.name}`, `**ID:** \`${data.automationId}\``,
+                            `**Trigger:** ${triggerLabel[data.triggerType] ?? data.triggerType}`,
+                            `**Action:** ${actionLabel[data.actionType] ?? data.actionType}`,
+                            data.priceBaselineUsd ? `**Baseline price:** $${Number(data.priceBaselineUsd).toLocaleString()}` : ``,
+                            ``, `Use \`list_automations\` to see all your automations.`,
+                        ].filter(Boolean).join("\n"),
+                    }],
+            };
+        }
+        case "list_automations": {
+            const data = await (0, convex_js_1.callConvex)("/automations/list", "GET", undefined, "list_automations");
+            if (data.error)
+                return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
+            const automations = data.automations ?? [];
+            if (!automations.length)
+                return { content: [{ type: "text", text: "No automations yet. Use `create_automation` to create one." }] };
+            const statusIcon = { active: "🟢", paused: "⏸️", completed: "✅", error: "❌" };
+            const lines = [`**Your Automations** (${automations.length})`, ""];
+            for (const auto of automations) {
+                lines.push(`${statusIcon[auto.status] ?? "•"} **${auto.name}** — \`${auto._id}\``);
+                lines.push(`  Trigger: ${auto.triggerType} | Action: ${auto.actionType} | Runs: ${auto.totalRuns}`);
+                if (auto.totalSpentUsd > 0)
+                    lines.push(`  Total spent: $${Number(auto.totalSpentUsd).toFixed(2)}`);
+                if (auto.nextRunAt && auto.status === "active")
+                    lines.push(`  Next run: ${new Date(auto.nextRunAt).toUTCString()}`);
+                if (auto.lastError)
+                    lines.push(`  ⚠️ Last error: ${auto.lastError}`);
+                lines.push("");
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        case "pause_automation": {
+            const parsed = AutomationIdSchema.safeParse(args);
+            if (!parsed.success)
+                return { content: [{ type: "text", text: `Invalid input: automationId ${parsed.error.issues[0].message}` }], isError: true };
+            const data = await (0, convex_js_1.callConvex)("/automations/pause", "POST", { automationId: parsed.data.automationId }, "pause_automation");
+            if (data.error)
+                return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
+            const icon = data.status === "active" ? "▶️ Resumed" : "⏸️ Paused";
+            return { content: [{ type: "text", text: `${icon} successfully.` }] };
+        }
+        case "delete_automation": {
+            const parsed = AutomationIdSchema.safeParse(args);
+            if (!parsed.success)
+                return { content: [{ type: "text", text: `Invalid input: automationId ${parsed.error.issues[0].message}` }], isError: true };
+            const data = await (0, convex_js_1.callConvex)("/automations/delete", "POST", { automationId: parsed.data.automationId }, "delete_automation");
+            if (data.error)
+                return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
+            return { content: [{ type: "text", text: "🗑️ Automation deleted." }] };
+        }
+        default:
+            return null;
+    }
+}