Setup & Configuration

The @noelclaw/mcp package runs via npx - no build step, no cloning, no local files needed. One command gives you all 121 tools in any MCP-compatible AI client.

Requirement: Node.js >= 18. Check with node --version. Download from nodejs.org if needed.

---

Claude Code

claude mcp add noelclaw -s user -- npx -y -p @noelclaw/mcp@3.43.1 noelclaw-mcp

Verify the server is registered:

claude mcp list
# noelclaw   npx -y -p @noelclaw/mcp@3.43.1 noelclaw-mcp

Then in any Claude Code session:

get_market_data

---

Claude Desktop

Mac - Edit ~/Library/Application Support/Claude/claude_desktop_config.json

Windows - Edit %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["-y", "-p", "@noelclaw/mcp@3.43.1", "noelclaw-mcp"]
    }
  }
}

Save the file, then restart Claude Desktop. all 121 tools appear automatically in the tool list.

---

Cursor

Via Settings UI

1. Open Cursor → Settings (Ctrl+, / Cmd+,)
2. Search MCP or go to Features → MCP
3. Add server:

   • Name: noelclaw
   • Command: npx
   • Args: -y -p @noelclaw/mcp@3.43.1 noelclaw-mcp

Via Config File

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["-y", "-p", "@noelclaw/mcp@3.43.1", "noelclaw-mcp"]
    }
  }
}

Restart Cursor. Tools appear in Composer when in Agent mode.

---

Windsurf

Edit ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["-y", "-p", "@noelclaw/mcp@3.43.1", "noelclaw-mcp"]
    }
  }
}

Restart Windsurf after saving.

---

Hermes

CLI Method

hermes mcp add noelclaw --command npx --args -y --args -p --args @noelclaw/mcp@3.43.1 --args noelclaw-mcp

Reload without restarting:

/reload-mcp

Config File Method

Edit ~/.hermes/config.yaml:

mcp_servers:
  noelclaw:
    command: npx
    args:
      - "-y"
      - "-p"
      - "@noelclaw/mcp@3.43.1"
      - "noelclaw-mcp"
    timeout: 30
    connect_timeout: 10

Then run /reload-mcp in any Hermes session.

---

Aeon

See Aeon integration guide for the full setup.

Quick install via Aeon skill registry:

aeon skill add noelclaw

Or add manually to your Aeon config - see the Aeon page.

---

Any MCP Client

If your client accepts a generic MCP server definition:

{
  "command": "npx",
  "args": ["-y", "-p", "@noelclaw/mcp@3.43.1", "noelclaw-mcp"]
}

---

First Steps After Install

1. Confirm tools are loaded

Ask your AI client:

list all noelclaw tools

You should see 121 tools.

2. Pull live market data

get_market_data

3. Check your portfolio

base_mcp_balance

4. Ask Noel

ask_noel question: "What's your read on BTC right now?"

5. Save something to vault

vault_save type: "memory" title: "First Note" content: "Started using noelclaw"

---

Optional: Environment Variables

Pass env vars to unlock extra tools or use your own API keys:

{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["-y", "-p", "@noelclaw/mcp@3.43.1", "noelclaw-mcp"],
      "env": {
        "MINIMAX_API_KEY": "your-key",
        "BANKR_API_KEY": "your-key"
      }
    }
  }
}

See Environment Variables for the full list.

---

Troubleshooting

Problem	Fix
Tools not showing	Restart your MCP client after saving the config
npx: command not found	Install Node.js 18+ from nodejs.org
Server starts but no response	Normal - the MCP server waits for stdin (MCP protocol), it does not serve HTTP
Slow first start	npx downloads the package on first run. Subsequent starts are instant
connect_timeout errors	Increase to connect_timeout: 20 in your config - first run takes longer
Coder tools fail	Requires BANKR_API_KEY env var