From 531504772e1c8e52e34f4630e41fc700ab71ec4e Mon Sep 17 00:00:00 2001 From: noelclaw Date: Fri, 29 May 2026 07:18:23 -0700 Subject: [PATCH] =?UTF-8?q?feat:=20add=20noelclaw=20skill=20=E2=80=94=2034?= =?UTF-8?q?-tool=20MCP=20agent=20with=20DeFi,=20automations,=20swarm,=20va?= =?UTF-8?q?ult?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- noelclaw/SKILL.md | 117 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 noelclaw/SKILL.md diff --git a/noelclaw/SKILL.md b/noelclaw/SKILL.md new file mode 100644 index 0000000000..4649a0b626 --- /dev/null +++ b/noelclaw/SKILL.md @@ -0,0 +1,117 @@ +# Noelclaw — Autonomous Crypto Agent Platform + +Noelclaw is a multi-agent crypto platform that turns plain-English instructions into on-chain actions. It combines a 34-tool MCP server, an NL-to-automation engine, a multi-agent swarm, and a persistent vault — all running on Base with USDC via x402. + +## Core Capabilities + +**Trading & DeFi (via 0x on Base)** +- Token swaps: `swap_tokens` — execute any ERC-20↔ERC-20 swap on Base through the user's custodial MCP wallet +- Token transfers: `send_token` — send ETH, USDC, USDT, DAI to any address +- Wallet resolution: `get_wallet_address` — look up or create a user's encrypted on-chain wallet + +**Natural Language Automations** +- `create_automation` — parse plain English into a structured trigger + action pair, then run on a cron + - **Triggers**: `schedule` (interval), `price_drop_%`, `price_rise_%`, `price_below`, `price_above`, `dominance_below`, `dominance_above` + - **Actions**: `swap`, `send`, `alert` (Telegram) + - **Limits**: `maxRuns`, `maxSpendUsd`, expiry + - Examples: *"Buy $50 of ETH every day, stop after $500"*, *"If ETH drops 10%, buy $100 USDC→ETH"*, *"Alert me when BTC dominance drops below 50%"* +- `list_automations` / `pause_automation` / `delete_automation` + +**Agent Swarm** +Five specialized sub-agents run autonomously when the swarm is active: +- **Market Monitor** — tracks live prices, detects volume spikes and resistance breaks +- **Sentiment Tracker** — scans on-chain signals and social data +- **Workflow Executor** — fires scheduled automations and DCA strategies +- **Memory Manager** — compresses and organises shared swarm memory +- **Risk Verifier** — gates every action through a configurable risk score threshold + +Tools: `start_swarm`, `stop_swarm`, `get_swarm_status`, `get_swarm_memory`, `write_swarm_memory`, `get_execution_scores`, `get_noel_ledger` + +**Market Intelligence** +- `get_market_data` — live prices, trending coins, top-20 market cap via Bankr LLM API +- `get_token_data` — deep token analysis (price, volume, sentiment, on-chain activity) +- `ask_noel` — general crypto Q&A and reasoning, powered by Bankr LLM + +**MiroShark Simulation** +- `miroshark_simulate` — run a multi-agent market simulation (bull/bear/neutral scenario modelling) +- `miroshark_status` — check simulation result and sentiment breakdown + +**Vault (Persistent Agent Memory)** +- `vault_save` / `vault_read` / `vault_search` / `vault_list` — store and retrieve agent outputs, strategies, research notes +- `vault_history` / `vault_diff` / `vault_export` — version history and diff between entries + +**Other** +- `post_tweet` — post to X/Twitter with optional humanization +- `humanize_text` — rewrite AI-generated text to sound natural +- `set_telegram` — link a Telegram chat for alert delivery + +## Access + +**MCP Server** + +```bash +npx noelclaw-mcp +``` + +Add to Claude Desktop or any MCP-compatible client: +```json +{ + "mcpServers": { + "noelclaw": { + "command": "npx", + "args": ["noelclaw-mcp"], + "env": { "NOELCLAW_API_KEY": "your_key_here" } + } + } +} +``` + +Get your API key at **noelclaw.com/api-keys** (7 free keys per account). + +**HTTP API** +Base URL: `https://valuable-fish-533.convex.site` + +| Auth Method | Header | +|---|---| +| Session token | `Authorization: Bearer ` | +| x402 micropayment | Send USDC on Base → retry with `X-Payment: {"txHash":"...","requestId":"..."}` | +| Wallet signature | `X-Wallet-Address` + `X-Wallet-Signature` + `X-Wallet-Timestamp` | + +Free tools (`get_market_data`, `ask_noel`) pass through with no auth required. + +## Key Endpoints + +| Endpoint | Method | Description | +|---|---|---| +| `/mcp/market` | GET | Live prices, trending, top-20 | +| `/mcp/chat` | POST | Ask Noel any crypto question | +| `/automations/create` | POST | Create automation from plain English | +| `/automations/list` | GET | List user's automations | +| `/automations/pause` | POST | Pause or resume an automation | +| `/automations/delete` | POST | Delete an automation | +| `/swarm/start` | POST | Start the agent swarm | +| `/swarm/stop` | POST | Stop the swarm | +| `/swarm/status` | GET | Current swarm status + memory | +| `/swarm/scores` | GET | Agent execution scores | +| `/mcp/defi/swap` | POST | Get 0x swap quote | +| `/mcp/defi/send` | POST | Get send tx data | + +## Integration Pattern + +Noelclaw works as an **execution + intelligence layer** alongside Bankr: +- Use `get_market_data` / `ask_noel` for research (free, no auth) +- Use `create_automation` to set recurring DCA/alert strategies in plain English +- Use `swap_tokens` / `send_token` for immediate on-chain execution +- Use `start_swarm` for autonomous 24/7 market monitoring and execution +- Use `vault_save` to persist agent research and strategy outputs across sessions + +All swap/send operations go through the user's personal encrypted MCP wallet on Base. The swarm's risk-verifier gates every autonomous action against a configurable threshold before execution. + +## Tech Stack + +- **Bankr LLM API** (`llm.bankr.bot`) — all agent reasoning and market intelligence +- **x402 protocol** — native USDC micropayment support on Base +- **MCP (Model Context Protocol)** — 34 tools, stdio transport, v2.1.0 +- **Convex** — real-time backend, cron automation engine, swarm coordinator +- **0x Protocol v2** — on-chain swap execution on Base +- **Base mainnet** — all token operations and payments