> For the complete documentation index, see [llms.txt](https://docs.noelclaw.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.noelclaw.fun/getting-started/setup.md).

# 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](https://nodejs.org) if needed.

***

## Claude Code

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

Verify the server is registered:

```bash
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`

```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`:

```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`:

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

Restart Windsurf after saving.

***

## Hermes

### CLI Method

```bash
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`:

```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](/install-by-client/aeon.md) for the full setup.

Quick install via Aeon skill registry:

```bash
aeon skill add noelclaw
```

Or add manually to your Aeon config - see the [Aeon page](/install-by-client/aeon.md).

***

## Any MCP Client

If your client accepts a generic MCP server definition:

```json
{
  "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:

```json
{
  "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](/reference/env-vars.md) 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](https://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                                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.noelclaw.fun/getting-started/setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.