@noelclaw/mcp 1.4.1 → 1.5.1

package/README.md

@@ -1,238 +1,258 @@
-# @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
-```
-
----
-
-## Quick Install
-
-### Claude Code
-```bash
-claude mcp add noelclaw -- npx @noelclaw/mcp
-```
-
-Set your API key:
-```bash
-claude mcp add noelclaw -e NOELCLAW_API_KEY=noel_... -- npx @noelclaw/mcp
-```
-
-### 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"],
-      "env": {
-        "NOELCLAW_API_KEY": "noel_..."
-      }
-    }
-  }
-}
-```
-
-### Cursor / Windsurf
-```json
-{
-  "mcpServers": {
-    "noelclaw": {
-      "command": "npx",
-      "args": ["@noelclaw/mcp"],
-      "env": {
-        "NOELCLAW_API_KEY": "noel_..."
-      }
-    }
-  }
-}
-```
-
-### Hermes
-```yaml
-mcp_servers:
-  noelclaw:
-    command: npx
-    args:
-      - "@noelclaw/mcp"
-    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` |
-
-### 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` |
-| 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/mcp](https://github.com/noelclaw/mcp)
-- Platform: [noelclaw.com](https://noelclaw.com)
+# @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.
+
+**37 tools** across market data, research, vault, swarm, MiroShark simulation, DeFi, automation, and framework.
+
+```bash
+npx @noelclaw/mcp
+```
+
+---
+
+## Quick Install
+
+### Claude Code
+```bash
+claude mcp add noelclaw -e NOELCLAW_API_KEY=noel_... -- npx @noelclaw/mcp
+```
+
+### 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"],
+      "env": {
+        "NOELCLAW_API_KEY": "noel_..."
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+```json
+{
+  "mcpServers": {
+    "noelclaw": {
+      "command": "npx",
+      "args": ["@noelclaw/mcp"],
+      "env": {
+        "NOELCLAW_API_KEY": "noel_..."
+      }
+    }
+  }
+}
+```
+
+### Hermes
+```yaml
+mcp_servers:
+  noelclaw:
+    command: npx
+    args:
+      - "@noelclaw/mcp"
+    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
+
+### Market Data
+
+| Tool | Description |
+|------|-------------|
+| `get_market_data` | Live prices for BTC, ETH, SOL — sourced from CoinGecko via swarm. Pass a token symbol to focus |
+| `get_token_data` | Price, 24h change, market cap, and volume for any specific token |
+
+### Research & AI
+
+| Tool | Description |
+|------|-------------|
+| `research` | Deep research via Bankr (real-time). Returns overview, key findings, market impact, sentiment |
+| `get_insight` | Noel's daily crypto + macro insight — price action, narratives, on-chain signals, one takeaway |
+| `ask_noel` | Ask Noel AI for DeFi analysis, trade ideas, and market research with live context |
+| `humanize_text` | Remove AI tells from text — fixes 29 AI patterns, makes output sound natural. Powered by MiniMax-M2.7. Requires `MINIMAX_API_KEY` |
+
+### 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, memory |
+| `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 full vault or filter by type |
+
+### Noel-Swarm
+
+> Shared memory bus for multi-agent coordination. All agents read/write the same store with freshness tracking and execution scoring.
+
+| 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. Use `market/*` / `dex/*` keys for live CoinGecko / DexScreener data |
+| `get_swarm_memory` | Read by key — returns value + freshness metadata |
+| `get_execution_scores` | Per-agent, per-skill performance scores |
+
+### MiroShark
+
+> Multi-agent scenario simulation — describe any scenario in plain English, get back a full simulation with AI agents acting as market participants, analysts, and social actors.
+
+| Tool | Description |
+|------|-------------|
+| `miroshark_simulate` | Run a simulation from a plain-English scenario. Handles full setup automatically (knowledge graph, 42+ agents). Returns a simulation ID |
+| `miroshark_status` | Poll progress — surfaces agent actions, round count, consensus when complete |
+
+No extra env vars needed. MiroShark is hosted on Noelclaw's infrastructure.
+
+### Wallet & DeFi `beta`
+
+> On-chain operations on Base mainnet. Transactions are signed client-side — no private key ever leaves your machine.
+
+| Tool | Description |
+|------|-------------|
+| `get_wallet_address` | Show your local MCP wallet address |
+| `swap_tokens` | Swap tokens on Base mainnet via 0x Permit2 (ETH, USDC, USDT, DAI, WETH) |
+| `send_token` | Send ETH or any ERC-20 to any address |
+| `claim_fees` | Claim accumulated ETH from Flaunch token swap fees |
+
+### 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. Every action checked against 5 mechanical rules before it runs.
+
+| 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 |
+
+### Social
+
+| Tool | Description |
+|------|-------------|
+| `post_tweet` | Post a tweet. Requires `TWITTER_BEARER_TOKEN` or delegated via Noelclaw |
+| `set_telegram` | Connect Telegram for push notifications from market and swarm events |
+
+---
+
+## Environment Variables
+
+### Required
+
+| Var | Description |
+|-----|-------------|
+| `NOELCLAW_API_KEY` | Your API key (`noel_...`) — get one at `POST https://api.noelclaw.com/auth/key` |
+
+### Optional
+
+| Var | Used for |
+|-----|---------|
+| `MINIMAX_API_KEY` | `humanize_text` tool — powered by MiniMax-M2.7 |
+| `BANKR_API_KEY` | `research` tool — Bankr Agent deep research |
+| `TELEGRAM_BOT_TOKEN` | Your own Telegram bot for notifications |
+| `TELEGRAM_CHAT_ID` | Your Telegram chat ID |
+| `ALCHEMY_API_KEY` | Faster Base RPC for swaps |
+| `GROK_API_KEY` | Grok integration via BYOK |
+
+---
+
+## Usage Examples
+
+```
+# Live market data
+get_market_data()                                          # BTC, ETH, SOL prices
+get_token_data(question: "What is the price of HYPE?")
+
+# Research
+research(query: "What is happening with the Base ecosystem this week?")
+get_insight()
+ask_noel(question: "What are the risks of holding ETH through a Fed meeting?")
+
+# Humanize AI-generated text
+humanize_text(text: "In today's rapidly evolving landscape, it is worth noting...")
+
+# Save findings to vault
+vault_save(type: "research", key: "research/base-may-2026", title: "Base Ecosystem", content: "...")
+vault_search(query: "Base ecosystem")
+vault_history(key: "research/base-may-2026")
+
+# Coordinate agents via swarm
+start_swarm()
+write_swarm_memory(agentId: "analyst", key: "research/btc", value: "bullish", ttlSeconds: 3600)
+get_swarm_memory(key: "market/BTC")    # real-time CoinGecko price
+get_swarm_memory(key: "dex/PEPE")     # real-time DexScreener data
+
+# Run a MiroShark simulation
+miroshark_simulate(scenario: "What happens if the US passes a Bitcoin strategic reserve bill?")
+miroshark_status(simulation_id: "sim_abc123")
+
+# DeFi (beta)
+swap_tokens(fromToken: "ETH", toToken: "USDC", amount: "0.01")
+send_token(token: "USDC", toAddress: "0x...", amount: "10")
+claim_fees()
+
+# 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` |
+| `humanize_text` fails | Set `MINIMAX_API_KEY` in your MCP env config |
+| `research` fails | Set `BANKR_API_KEY` — Bankr access required for deep research |
+| 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/mcp](https://github.com/noelclaw/mcp)
+- Platform: [noelclaw.com](https://noelclaw.com)

package/dist/index.js

@@ -19,7 +19,7 @@ async function main() {
     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`);
+        console.error(`\x1b[36m  ◆ status\x1b[0m  ready · 34 tools loaded\n`);
     }
     catch (err) {
         console.error(`[noelclaw] wallet init failed: ${err}`);

package/dist/server.js

@@ -34,9 +34,8 @@ function containsSensitiveRequest(args) {
 }
 exports.ALL_TOOLS = [
     ...market_js_1.MARKET_TOOLS, // 2 — market data, token data
-    ...research_js_1.RESEARCH_TOOLS, // 1 — deep research
-    ...insight_js_1.INSIGHT_TOOLS, // 2 — get_insight, ask_noel
-    ...defi_js_1.DEFI_TOOLS, // 3 — swap, send, claim
+    ...insight_js_1.INSIGHT_TOOLS, // 1 — ask_noel
+    ...defi_js_1.DEFI_TOOLS, // 2 — swap, send
     ...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
@@ -45,7 +44,7 @@ exports.ALL_TOOLS = [
     ...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: 37
+    // total: 34
 ];
 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 }));

package/dist/tools/defi.js

@@ -32,15 +32,6 @@ exports.DEFI_TOOLS = [
             required: ["token", "toAddress", "amount"],
         },
     },
-    {
-        name: "claim_fees",
-        description: "Claim accumulated ETH from your Flaunch token swap fees. Calls claim() on the Flaunch PositionManager — pulls all pending ETH from your deployed tokens to your wallet.",
-        inputSchema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    },
 ];
 const SwapSchema = zod_1.z.object({ fromToken: zod_1.z.string().min(1), toToken: zod_1.z.string().min(1), amount: zod_1.z.string().min(1) });
 const SendSchema = zod_1.z.object({ token: zod_1.z.string().min(1), toAddress: zod_1.z.string().regex(/^0x[0-9a-fA-F]{40}$/, "must be a valid 0x address"), amount: zod_1.z.string().min(1) });
@@ -50,7 +41,7 @@ async function handleDefiTool(name, args) {
             const parsed = SwapSchema.safeParse(args);
             if (!parsed.success)
                 return { content: [{ type: "text", text: `Invalid input: ${String(parsed.error.issues[0].path[0])} ${parsed.error.issues[0].message}` }], isError: true };
-            let { fromToken, toToken, amount } = parsed.data;
+            const { fromToken, toToken, amount } = parsed.data;
             const wallet = await (0, wallet_js_1.getOrCreateWallet)();
             const result = await (0, convex_js_1.callConvex)("/mcp/defi/swap", "POST", { fromToken, toToken, amount }, "swap_tokens");
             if (!result.success)
@@ -74,7 +65,6 @@ async function handleDefiTool(name, args) {
             if (!result.success)
                 return { content: [{ type: "text", text: `Send failed: ${result.error}` }], isError: true };
             const txHash = await (0, wallet_js_1.signAndBroadcast)(wallet, result.txData);
-            // Collect 0.5% platform fee as a separate tx if the server returned fee data
             if (result.feeTxData) {
                 try {
                     await (0, wallet_js_1.signAndBroadcast)(wallet, result.feeTxData);
@@ -88,19 +78,6 @@ async function handleDefiTool(name, args) {
                     }],
             };
         }
-        case "claim_fees": {
-            const wallet = await (0, wallet_js_1.getOrCreateWallet)();
-            const result = await (0, convex_js_1.callConvex)("/mcp/token/claim", "POST", {}, "claim_fees");
-            if (result.error)
-                return { content: [{ type: "text", text: `Claim failed: ${result.error}` }], isError: true };
-            const txHash = await (0, wallet_js_1.signAndBroadcast)(wallet, result);
-            return {
-                content: [{
-                        type: "text",
-                        text: [`✅ ETH claimed successfully!`, `Tx Hash: \`${txHash}\``, `https://basescan.org/tx/${txHash}`].join("\n"),
-                    }],
-            };
-        }
         default:
             return null;
     }

package/dist/tools/insight.js

@@ -5,11 +5,6 @@ exports.handleInsightTool = handleInsightTool;
 const zod_1 = require("zod");
 const convex_js_1 = require("../convex.js");
 exports.INSIGHT_TOOLS = [
-    {
-        name: "get_insight",
-        description: "Get Noel's daily crypto + macro insight. Covers Bitcoin/ETH price action, macro events, trending narratives on X/Twitter, and one actionable takeaway.",
-        inputSchema: { type: "object", properties: {}, required: [] },
-    },
     {
         name: "ask_noel",
         description: "Ask Noel AI for DeFi analysis, trade ideas, market outlook, and crypto research. Noel has live market context.",
@@ -36,24 +31,15 @@ const AskNoelSchema = zod_1.z.object({
     messages: zod_1.z.array(zod_1.z.object({ role: zod_1.z.enum(["user", "assistant"]), content: zod_1.z.string() })).optional(),
 });
 async function handleInsightTool(name, args) {
-    switch (name) {
-        case "get_insight": {
-            const data = await (0, convex_js_1.callConvex)("/insights/now", "GET", undefined, "get_insight");
-            const insight = data.insight ?? data.text ?? data.choices?.[0]?.message?.content ?? "Failed to get insight";
-            return { content: [{ type: "text", text: insight }] };
-        }
-        case "ask_noel": {
-            const parsed = AskNoelSchema.safeParse(args);
-            if (!parsed.success)
-                return { content: [{ type: "text", text: `Invalid input: question ${parsed.error.issues[0].message}` }], isError: true };
-            const data = await (0, convex_js_1.callConvex)("/mcp/chat", "POST", {
-                question: parsed.data.question,
-                agentId: "noel-default",
-                messages: parsed.data.messages ?? [],
-            }, "ask_noel");
-            return { content: [{ type: "text", text: data.answer ?? JSON.stringify(data) }] };
-        }
-        default:
-            return null;
-    }
+    if (name !== "ask_noel")
+        return null;
+    const parsed = AskNoelSchema.safeParse(args);
+    if (!parsed.success)
+        return { content: [{ type: "text", text: `Invalid input: question ${parsed.error.issues[0].message}` }], isError: true };
+    const data = await (0, convex_js_1.callConvex)("/mcp/chat", "POST", {
+        question: parsed.data.question,
+        agentId: "noel-default",
+        messages: parsed.data.messages ?? [],
+    }, "ask_noel");
+    return { content: [{ type: "text", text: data.answer ?? JSON.stringify(data) }] };
 }

package/dist/tools/market.js

@@ -1,70 +1,163 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MARKET_TOOLS = void 0;
+exports.fetchMarketSnapshot = fetchMarketSnapshot;
 exports.handleMarketTool = handleMarketTool;
 const zod_1 = require("zod");
-const convex_js_1 = require("../convex.js");
+const COINGECKO = "https://api.coingecko.com/api/v3";
+const SYMBOL_TO_ID = {
+    BTC: "bitcoin", ETH: "ethereum", SOL: "solana", BNB: "binancecoin",
+    USDT: "tether", USDC: "usd-coin", XRP: "ripple", DOGE: "dogecoin",
+    ADA: "cardano", AVAX: "avalanche-2", DOT: "polkadot", LINK: "chainlink",
+    UNI: "uniswap", OP: "optimism", ARB: "arbitrum", PEPE: "pepe",
+    SUI: "sui", APT: "aptos", NEAR: "near", INJ: "injective-protocol",
+    TIA: "celestia", MATIC: "matic-network", TON: "the-open-network",
+    SHIB: "shiba-inu", WIF: "dogwifcoin", BONK: "bonk", HYPE: "hyperliquid",
+};
+async function cgFetch(path) {
+    const res = await fetch(`${COINGECKO}${path}`, {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!res.ok)
+        throw new Error(`CoinGecko ${res.status}`);
+    return res.json();
+}
+function fmt(n, decimals = 2) {
+    if (n == null)
+        return "—";
+    return n.toLocaleString("en-US", { maximumFractionDigits: decimals });
+}
+function fmtPrice(n) {
+    if (n == null)
+        return "—";
+    if (n >= 1)
+        return `$${n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    return `$${n.toPrecision(4)}`;
+}
+function fmtB(n) {
+    if (n == null)
+        return "—";
+    if (n >= 1e9)
+        return `$${(n / 1e9).toFixed(2)}B`;
+    if (n >= 1e6)
+        return `$${(n / 1e6).toFixed(1)}M`;
+    return `$${fmt(n)}`;
+}
 exports.MARKET_TOOLS = [
     {
         name: "get_market_data",
-        description: "Get live crypto market data: top 20 coins by market cap, trending coins, and key prices for BTC/ETH/SOL. Results are also sent to your Telegram if configured.",
+        description: "Get live crypto market data: top 20 coins by market cap, trending coins, and key prices for BTC/ETH/SOL.",
         inputSchema: {
             type: "object",
-            properties: { token: { type: "string", description: "Optional: specific token to focus on, e.g. 'BTC', 'ETH'" } },
+            properties: { token: { type: "string", description: "Optional: focus on a specific token, e.g. 'BTC', 'ETH'" } },
             required: [],
         },
     },
     {
         name: "get_token_data",
-        description: "Get market data for specific tokens. Returns price, 24h change, market cap, and volume. Results are sent to your Telegram if configured.",
+        description: "Get live market data for a specific token. Returns price, 24h change, market cap, and volume.",
         inputSchema: {
             type: "object",
-            properties: { question: { type: "string", description: "Describe which tokens to look up" } },
+            properties: { question: { type: "string", description: "Token to look up, e.g. 'ETH', 'show me SOL', 'PEPE price'" } },
             required: ["question"],
         },
     },
 ];
 const GetMarketDataSchema = zod_1.z.object({ token: zod_1.z.string().optional() });
 const GetTokenDataSchema = zod_1.z.object({ question: zod_1.z.string().min(1) });
+async function fetchMarketSnapshot() {
+    try {
+        const data = await cgFetch("/coins/markets?vs_currency=usd&ids=bitcoin,ethereum,solana&sparkline=false&price_change_percentage=24h");
+        const find = (id) => data.find((c) => c.id === id)?.current_price ?? null;
+        return { btc: find("bitcoin"), eth: find("ethereum"), sol: find("solana") };
+    }
+    catch {
+        return null;
+    }
+}
 async function handleMarketTool(name, args) {
     switch (name) {
         case "get_market_data": {
             const parsed = GetMarketDataSchema.safeParse(args ?? {});
             if (!parsed.success)
-                return { content: [{ type: "text", text: `Invalid input: token ${parsed.error.issues[0].message}` }], isError: true };
+                return { content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }], isError: true };
             const { token } = parsed.data;
-            const symbols = token ? [token.toUpperCase()] : ["BTC", "ETH", "SOL"];
-            const results = await Promise.all(symbols.map((s) => (0, convex_js_1.callConvex)(`/swarm/memory/read?key=market/${s}`, "GET", undefined, "get_market_data")));
-            const lines = [`**Market Data** — ${new Date().toISOString()}`, ""];
-            for (const d of results) {
-                if (d.error)
+            if (token) {
+                const sym = token.toUpperCase();
+                const id = SYMBOL_TO_ID[sym];
+                if (!id)
+                    return { content: [{ type: "text", text: `Unknown token: ${sym}. Try get_token_data for specific lookup.` }], isError: true };
+                const [data, trending] = await Promise.all([
+                    cgFetch(`/coins/markets?vs_currency=usd&ids=${id}&sparkline=false&price_change_percentage=24h`),
+                    cgFetch("/search/trending"),
+                ]);
+                const c = data[0];
+                if (!c)
+                    return { content: [{ type: "text", text: `No data for ${sym}` }], isError: true };
+                const sign = (c.price_change_percentage_24h ?? 0) >= 0 ? "+" : "";
+                const lines = [
+                    `**${c.symbol?.toUpperCase()} — ${c.name}**`,
+                    `Price: ${fmtPrice(c.current_price)} (${sign}${fmt(c.price_change_percentage_24h)}% 24h)`,
+                    `Market Cap: ${fmtB(c.market_cap)} (rank #${c.market_cap_rank ?? "—"})`,
+                    `Volume 24h: ${fmtB(c.total_volume)}`,
+                    `High/Low 24h: ${fmtPrice(c.high_24h)} / ${fmtPrice(c.low_24h)}`,
+                    "",
+                    `_Source: CoinGecko · ${new Date().toUTCString()}_`,
+                ];
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            const [top20, trending] = await Promise.all([
+                cgFetch("/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=20&page=1&sparkline=false&price_change_percentage=24h"),
+                cgFetch("/search/trending"),
+            ]);
+            const lines = [`**Crypto Market Overview** — ${new Date().toUTCString()}`, ""];
+            lines.push("**Key Prices**");
+            for (const sym of ["BTC", "ETH", "SOL"]) {
+                const c = top20.find((x) => x.symbol?.toUpperCase() === sym);
+                if (!c)
                     continue;
-                const price = d.price_usd?.toLocaleString("en-US", { style: "currency", currency: "USD" });
-                const ch = d.change_24h_pct?.toFixed(2);
-                const sign = (d.change_24h_pct ?? 0) >= 0 ? "+" : "";
-                lines.push(`• **${d.symbol}**: ${price} (${sign}${ch}%) — mcap $${(d.market_cap_usd / 1e9).toFixed(1)}B`);
+                const sign = (c.price_change_percentage_24h ?? 0) >= 0 ? "+" : "";
+                lines.push(`• **${sym}**: ${fmtPrice(c.current_price)} (${sign}${fmt(c.price_change_percentage_24h)}% 24h) — mcap ${fmtB(c.market_cap)}`);
+            }
+            lines.push("", "**Top 20 by Market Cap**");
+            for (const c of top20) {
+                const sym = c.symbol?.toUpperCase();
+                const sign = (c.price_change_percentage_24h ?? 0) >= 0 ? "+" : "";
+                lines.push(`${c.market_cap_rank}. **${sym}** ${fmtPrice(c.current_price)} (${sign}${fmt(c.price_change_percentage_24h)}%) — ${fmtB(c.market_cap)}`);
+            }
+            const trendingCoins = trending?.coins?.slice(0, 7) ?? [];
+            if (trendingCoins.length > 0) {
+                lines.push("", "**Trending**");
+                for (const t of trendingCoins) {
+                    const item = t.item;
+                    lines.push(`• **${item.symbol}** (#${item.market_cap_rank ?? "—"}) — ${item.name}`);
+                }
             }
+            lines.push("", `_Source: CoinGecko_`);
             return { content: [{ type: "text", text: lines.join("\n") }] };
         }
         case "get_token_data": {
             const parsed = GetTokenDataSchema.safeParse(args);
             if (!parsed.success)
-                return { content: [{ type: "text", text: `Invalid input: question ${parsed.error.issues[0].message}` }], isError: true };
+                return { content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }], isError: true };
             const q = parsed.data.question.toUpperCase();
-            const KNOWN = ["BTC", "ETH", "SOL", "BNB", "USDT", "USDC", "XRP", "DOGE", "ADA", "AVAX", "DOT", "LINK", "UNI", "OP", "ARB", "HYPE", "PEPE", "SUI", "APT", "NEAR", "INJ", "TIA", "MATIC", "TON", "SHIB", "WIF", "BONK"];
-            const found = KNOWN.find((t) => new RegExp(`\\b${t}\\b`).test(q)) ?? "BTC";
-            const data = await (0, convex_js_1.callConvex)(`/swarm/memory/read?key=market/${found}`, "GET", undefined, "get_token_data");
-            if (data.error)
-                return { content: [{ type: "text", text: `Error fetching ${found}: ${data.error}` }], isError: true };
-            const price = data.price_usd?.toLocaleString("en-US", { style: "currency", currency: "USD" });
-            const ch = data.change_24h_pct?.toFixed(2);
-            const sign = (data.change_24h_pct ?? 0) >= 0 ? "+" : "";
+            const sym = Object.keys(SYMBOL_TO_ID).find((s) => new RegExp(`\\b${s}\\b`).test(q)) ?? "BTC";
+            const id = SYMBOL_TO_ID[sym];
+            const data = await cgFetch(`/coins/markets?vs_currency=usd&ids=${id}&sparkline=false&price_change_percentage=24h`);
+            const c = data[0];
+            if (!c)
+                return { content: [{ type: "text", text: `No data found for ${sym}` }], isError: true };
+            const sign = (c.price_change_percentage_24h ?? 0) >= 0 ? "+" : "";
             const lines = [
-                `**${data.symbol}** — ${data.fetchedAt}`,
-                `Price: ${price} (${sign}${ch}% 24h)`,
-                `Market Cap: $${(data.market_cap_usd / 1e9).toFixed(2)}B`,
-                `Volume 24h: $${(data.volume_24h_usd / 1e9).toFixed(2)}B`,
-                `Source: ${data.source}`,
+                `**${c.symbol?.toUpperCase()} — ${c.name}**`,
+                `Price: ${fmtPrice(c.current_price)} (${sign}${fmt(c.price_change_percentage_24h)}% 24h)`,
+                `Market Cap: ${fmtB(c.market_cap)} (rank #${c.market_cap_rank ?? "—"})`,
+                `Volume 24h: ${fmtB(c.total_volume)}`,
+                `High/Low 24h: ${fmtPrice(c.high_24h)} / ${fmtPrice(c.low_24h)}`,
+                `All-Time High: ${fmtPrice(c.ath)} (${c.ath_change_percentage != null ? fmt(c.ath_change_percentage) + "% from ATH" : "—"})`,
+                "",
+                `_Source: CoinGecko · ${new Date().toUTCString()}_`,
             ];
             return { content: [{ type: "text", text: lines.join("\n") }] };
         }

package/dist/tools/research.js

@@ -2,28 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RESEARCH_TOOLS = void 0;
 exports.handleResearchTool = handleResearchTool;
-const zod_1 = require("zod");
-const convex_js_1 = require("../convex.js");
-exports.RESEARCH_TOOLS = [
-    {
-        name: "research",
-        description: "Research any crypto topic on demand — like Perplexity but for crypto. Ask about a token, protocol, market event, or trend. Noel searches the web and returns a structured analysis.",
-        inputSchema: {
-            type: "object",
-            properties: { query: { type: "string", description: "Topic to research" } },
-            required: ["query"],
-        },
-    },
-];
-const ResearchSchema = zod_1.z.object({ query: zod_1.z.string().min(1) });
-async function handleResearchTool(name, args) {
-    if (name !== "research")
-        return null;
-    const parsed = ResearchSchema.safeParse(args);
-    if (!parsed.success)
-        return { content: [{ type: "text", text: `Invalid input: query ${parsed.error.issues[0].message}` }], isError: true };
-    const data = await (0, convex_js_1.callConvex)("/mcp/research", "POST", { query: parsed.data.query }, "research");
-    if (!data.success)
-        return { content: [{ type: "text", text: `Research failed: ${data.error ?? "unknown error"}` }] };
-    return { content: [{ type: "text", text: data.text ?? "No results returned." }] };
+exports.RESEARCH_TOOLS = [];
+async function handleResearchTool(_name, _args) {
+    return null;
 }

package/dist/tools/swarm.js

@@ -4,6 +4,7 @@ exports.SWARM_TOOLS = void 0;
 exports.handleSwarmTool = handleSwarmTool;
 const zod_1 = require("zod");
 const convex_js_1 = require("../convex.js");
+const market_js_1 = require("./market.js");
 exports.SWARM_TOOLS = [
     {
         name: "start_swarm",
@@ -79,10 +80,27 @@ async function handleSwarmTool(name, args) {
             const data = await (0, convex_js_1.callConvex)("/swarm/start", "POST", { config: parsed.data.config }, "start_swarm");
             if (!data.success)
                 return { content: [{ type: "text", text: `Failed: ${data.error}` }], isError: true };
+            const snapshot = await (0, market_js_1.fetchMarketSnapshot)();
+            if (snapshot) {
+                const ts = new Date().toUTCString();
+                const fmt = (n) => `$${n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} (${ts})`;
+                await Promise.all([
+                    (0, convex_js_1.callConvex)("/swarm/memory/write", "POST", { agentId: "market-monitor", key: "BTC/USD", value: fmt(snapshot.btc) }, "write_swarm_memory"),
+                    (0, convex_js_1.callConvex)("/swarm/memory/write", "POST", { agentId: "market-monitor", key: "ETH/USD", value: fmt(snapshot.eth) }, "write_swarm_memory"),
+                    (0, convex_js_1.callConvex)("/swarm/memory/write", "POST", { agentId: "market-monitor", key: "SOL/USD", value: fmt(snapshot.sol) }, "write_swarm_memory"),
+                ]);
+            }
             return {
                 content: [{
                         type: "text",
-                        text: [`🤖 **Swarm Started**`, `Session ID: ${data.sessionId}`, `Started at: ${data.startedAt}`, ``, `Use \`get_swarm_status\` to monitor, \`stop_swarm\` to stop.`].join("\n"),
+                        text: [
+                            `🤖 **Swarm Started**`,
+                            `Session ID: ${data.sessionId}`,
+                            `Started at: ${data.startedAt}`,
+                            snapshot ? `Market: BTC $${snapshot.btc.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} | ETH $${snapshot.eth.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} | SOL $${snapshot.sol.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}` : "",
+                            ``,
+                            `Use \`get_swarm_status\` to monitor, \`stop_swarm\` to stop.`,
+                        ].filter(Boolean).join("\n"),
                     }],
             };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noelclaw/mcp",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "description": "Noelclaw as an MCP skill — persistent memory, multi-agent coordination, scenario simulation, DeFi execution, and Sentinel-gated playbooks.",
   "main": "dist/index.js",
   "bin": {