@noelclaw/research

Noelclaw as an MCP skill — crypto intelligence, DeFi execution, multi-agent swarm, and the Noel Framework. Gives Claude, Cursor, Hermes, and any MCP-compatible AI client access to live signals, whale tracking, on-chain DeFi, autonomous agent swarms, and Sentinel-gated playbooks.

npx @noelclaw/research@latest

No API key required. A local wallet is auto-generated on first run and signs every request. Keys never leave your machine.

Quick Install

Claude Code

claude mcp add noelclaw -- npx @noelclaw/research@latest

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["@noelclaw/research@latest"],
      "env": {
        "NOELCLAW_API_KEY": "noel_sk_xxx"
      }
    }
  }
}

Cursor / Windsurf

Open Settings → MCP or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["@noelclaw/research@latest"]
    }
  }
}

Hermes Agent

hermes mcp add noelclaw --command npx --args @noelclaw/research@latest

Or in your Hermes config:

mcp_servers:
  noelclaw:
    command: npx
    args:
      - "@noelclaw/research@latest"

Tools (35)

Market & Signals

| Tool | Description | |------|-------------| | get_market_data | Live top-20 coins by market cap, trending coins, BTC/ETH/SOL prices | | get_token_data | Price, 24h change, market cap, and volume for any token | | get_latest_signal | Latest BTC and/or ETH 1H trading signals — entry, TP1, TP2, stop loss, confidence | | get_signal_history | Signal history with win/loss record and winrate stats | | get_smart_money_alerts | Smart money and insider wallet movements for micro-cap tokens | | get_daily_recap | Today's trading performance recap with winrate, PnL stats, and AI review | | get_news | Latest crypto news digest — top stories, regulatory updates, sentiment summary | | generate_signal | Manually trigger a fresh BTC/ETH signal right now (don't wait for 08:00 UTC cron) |

Research & AI

| Tool | Description | |------|-------------| | research | Deep crypto research — like Perplexity but for crypto. Returns overview, findings, market impact, affected tokens, and sentiment | | get_insight | Live crypto + macro briefing — what's happening right now in crypto, macro, and X/Twitter | | ask_noel | Ask Noel AI for DeFi analysis, trade ideas, market outlook, and crypto research |

Wallet & DeFi

| Tool | Description | |------|-------------| | get_wallet_address | Show your local MCP wallet address on Base mainnet | | get_portfolio | Full token portfolio on Base mainnet with ETH and ERC-20 balances and USD values | | swap_tokens | Swap ETH, USDC, USDT, DAI, WETH on Base mainnet via 0x Permit2 | | send_token | Send ETH or any ERC-20 token to any address on Base mainnet | | deploy_token | Deploy a new ERC-20 token on Base mainnet | | claim_fees | Claim accumulated protocol fees | | mint_nft | Mint an NFT on Base mainnet |

Automations

| Tool | Description | |------|-------------| | create_automation | Create an automation in plain English — DCA, price alerts, conditional buys/sells | | list_automations | List all your automations with status, run counts, and next scheduled run | | pause_automation | Pause or resume an automation by ID | | delete_automation | Permanently delete an automation |

Swarm

| Tool | Description | |------|-------------| | start_swarm | Start the multi-agent swarm — market monitor, sentiment tracker, workflow executor, memory manager, risk verifier | | stop_swarm | Stop the active swarm session | | get_swarm_status | Active agents, shared memory snapshot, execution scores, recent runs | | write_swarm_memory | Write a key-value entry to the swarm's shared memory (with optional TTL) | | get_swarm_memory | Read a value from the swarm's shared memory by key | | get_execution_scores | Which workflows are improving — success rate, win/loss, avg duration, last adapted |

Noel Framework

Sentinel-gated agent execution. Define what your AI can and can't do — before it runs.

| Tool | Description | |------|-------------| | create_task_packet | Convert plain-English intent into a structured task scope (territory, permissions, doNotDo constraints) | | list_task_packets | List all your task packets — draft, active, completed, blocked | | list_playbooks | List available playbooks — 4 system playbooks + any you've created | | run_playbook | Execute a Sentinel-gated playbook — halts immediately if any step is blocked | | get_noel_ledger | Full audit trail of every Sentinel decision — approved, warned, or blocked | | get_sentinel_rules | Exact rules for each agent role — territory, permissions, blocked actions, value caps |

Account & Notifications

| Tool | Description | |------|-------------| | set_telegram | Connect Telegram for push notifications — signals, whale alerts, daily recaps |

Noel Framework

The first Sentinel-gated agent execution system for crypto.

User defines Task Packet (plain English)
        ↓
Playbook runs step by step
        ↓
┌──────────────┐
│   Sentinel   │  ← mechanical gate, runs before EVERY step
│   5 checks   │
└──────────────┘
        ↓
  approved / warned / blocked
        ↓
Swarm Agent executes
(Scout → read-only · Tinker → execute · Skeptic → verify · Memory → store)
        ↓
Noel Ledger — immutable audit trail

5 Sentinel checks (mechanical, not prompt-based):

| Check | Description | |-------|-------------| | DoNotDo | Is this action explicitly forbidden in the task packet? | | Territory | Is this action within the agent's allowed domain? | | Value limit | Does this exceed the USD cap? | | Grudge book | Is this agent or user flagged for bad behavior? | | Rate limit | Too many actions in the last 60 seconds? |

4 system playbooks:

| Playbook | Steps | Roles | |----------|-------|-------| | Daily Market Scan | 4 | Scout → Scout → Scout → Memory | | DCA Setup | 4 | Scout → Scout → Skeptic → Tinker | | Portfolio Rebalance Check | 4 | Scout → Scout → Scout → Skeptic | | Swarm Intel Sweep | 4 | Tinker → Scout → Scout → Skeptic |

Example:

create_task_packet(task: "DCA $10 of ETH daily for 30 days. Never spend more than $15 in one day.")
list_playbooks
run_playbook(playbook_name: "DCA Setup")
get_noel_ledger

Agent Swarm

5 coordinated agents that run autonomously and improve over time via shared memory.

| Agent | Role | |-------|------| | market-monitor | Fetches live prices, detects significant moves, writes to shared memory (5min TTL) | | sentiment-tracker | Analyses token sentiment from on-chain signals, fires alerts at ±0.5 score | | workflow-executor | Finds due automations and executes — swaps, sends, alerts | | memory-manager | Watches memory size, compresses oldest entries when >50 | | risk-verifier | Gates high-value actions, triggers 10min cooldown on rejection |

All agents share a swarmMemory key-value store. Every run is logged and scored. Thresholds auto-adapt every 30 minutes.

Authentication

Wallet-native (automatic — no setup)

A wallet is auto-generated at ~/.noelclaw/wallet.json on first run. Every request is signed with noelclaw:{toolName}:{timestamp} (ECDSA secp256k1). Your wallet address is your identity.

To strengthen encryption, set a passphrase:

{ "env": { "NOELCLAW_WALLET_PASSPHRASE": "your-secret" } }

Without it, the wallet file is encrypted with machine info only (convenience, not security).

API key (optional — links to your account)

{ "env": { "NOELCLAW_API_KEY": "noel_sk_xxx" } }

Get your key at noelclaw.xyz → Settings → API Keys.

x402 per-call payment (no account needed)

1. Call any paid tool — you get a 402 response with amount, address, and request ID
2. Send the exact USDC amount to the address on Base mainnet
3. Build the header: base64("<txHash>:<requestId>")
4. Set NOELCLAW_PAYMENT_HEADER and retry

Each payment header is single-use. Clear it after success.

Environment Variables

No env vars required. Wallet auth is automatic.

Auth

| Var | Description | |-----|-------------| | NOELCLAW_API_KEY | Link to your noelclaw.xyz account (noel_sk_xxx) | | NOELCLAW_SESSION_TOKEN | Alternative: web session token from noelclaw.xyz | | NOELCLAW_WALLET_PASSPHRASE | Passphrase for stronger wallet file encryption |

Payments

| Var | Description | |-----|-------------| | NOELCLAW_PAYMENT_HEADER | Single-use x402 payment proof: base64(txHash:requestId) |

BYOK (Bring Your Own Key)

| Var | Used for | |-----|---------| | GROK_API_KEY | X.AI Grok — get_insight, signal generation | | BANKR_API_KEY | Bankr Agent — swarm agents, research | | TELEGRAM_BOT_TOKEN | Your own Telegram bot (instead of @NoelclawBot) | | TELEGRAM_CHAT_ID | Your Telegram chat ID for notifications |

Advanced

| Var | Default | Description | |-----|---------|-------------| | ALCHEMY_API_KEY | — | Faster/more reliable Base RPC for swaps and portfolio | | NOELCLAW_CONVEX_URL | https://api.noelclaw.com | Override for self-hosted deployment |

Tool Prices

| Tool | Price | |------|-------| | get_market_data, get_token_data, get_latest_signal, get_signal_history | Free | | get_news, get_wallet_address, set_telegram | Free | | get_swarm_status, get_execution_scores, write_swarm_memory, get_swarm_memory | Free | | list_automations, pause_automation, delete_automation, stop_swarm | Free | | create_task_packet, list_task_packets, list_playbooks, get_noel_ledger, get_sentinel_rules | Free | | get_portfolio | $0.002 | | get_smart_money_alerts, get_daily_recap, ask_noel, get_insight, get_news | $0.005 | | swap_tokens, send_token, generate_signal | $0.005 | | create_automation, run_playbook | $0.01 | | research, start_swarm, deploy_token, mint_nft | $0.02 |

Usage Examples

# Live market check
get_market_data

# Fresh BTC signal right now
generate_signal(token: "BTC")

# Latest news digest
get_news(limit: 5)

# Ask anything
ask_noel(question: "Is ETH forming a breakout on the 1H chart?")

# Research a topic
research(query: "What is happening with the Base ecosystem this week?")

# Check portfolio and swap
get_portfolio
swap_tokens(fromToken: "ETH", toToken: "USDC", amount: "0.01")

# DCA automation
create_automation(rawInput: "Buy 50 USDC of ETH every day. Stop after 500 USDC total.")

# Start swarm
start_swarm
get_swarm_status

# Sentinel-gated playbook
create_task_packet(task: "Monitor ETH price, max $0 spend, only read market data")
run_playbook(playbook_name: "Daily Market Scan")
get_noel_ledger

# Check your wallet address
get_wallet_address

# Connect Telegram notifications
set_telegram(chat_id: "123456789")

Troubleshooting

| Error | Fix | |-------|-----| | Tools not appearing | Restart your MCP client after adding the config | | Noelclaw API error: 404 | Wrong NOELCLAW_CONVEX_URL or Convex not deployed | | 401 Unauthorized | Set NOELCLAW_API_KEY or let wallet auth auto-run | | Payment required on every call | Set NOELCLAW_API_KEY — wallet auth is automatic but API key gives full access | | Payment already used | Each NOELCLAW_PAYMENT_HEADER is single-use — clear after success | | Server starts but no response | Expected — waits for MCP stdin, not HTTP | | Wallet decrypt error | NOELCLAW_WALLET_PASSPHRASE mismatch, or delete ~/.noelclaw/wallet.json to regenerate | | Swarm not starting | Make sure Convex is deployed with swarm files | | High token usage in swarm | Set BANKR_API_KEY to use your own key |

Links

• npm: npmjs.com/package/@noelclaw/research
• GitHub: github.com/noelclaw/research
• Docs: docs.noelclaw.xyz
• Platform: noelclaw.xyz
• Telegram: @noelclaw

License

MIT — free to use, fork, and build on.