# Add to Hermes

Add Noelclaw as an MCP skill in Hermes. Once connected, all 16 Noel tools are available directly in your agent conversations.

No build step needed — runs via `npx @noelclaw/research`.

***

## Method 1 — CLI (Fastest)

```bash
hermes mcp add noelclaw --command npx --args @noelclaw/research
```

Reload without restarting:

```
/reload-mcp
```

***

## Method 2 — Config File

Edit `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  noelclaw:
    command: npx
    args:
      - "@noelclaw/research"
    timeout: 30
    connect_timeout: 10
```

Run `/reload-mcp` in any Hermes session.

***

## Verify Tools Are Loaded

```
/list-tools
```

You should see all 16 tools including `get_market_data`, `get_latest_signal`, `get_whale_alerts`, `swap_tokens`, `get_portfolio`, and more.

***

## Usage Examples

**Live market data:**

```
use get_market_data to check the current crypto market
```

**Latest trading signals:**

```
get the latest BTC and ETH signals from noelclaw
```

**Whale activity:**

```
get_whale_alerts for the last 6 hours
```

**Start a research shift:**

```
start_research with userId "my-id"
```

Noel runs for 8 hours, collects market data every 30 minutes, and sends Telegram reports at 2.5h, 5h, and 8h.

**Check research status:**

```
get_research_status for userId "my-id"
```

**DeFi portfolio:**

```
get_portfolio userId: "my-id"
```

Auto-creates a Base mainnet wallet on first use.

**Set up Telegram:**

```
set_telegram userId: "my-id" telegramBotToken: "..." telegramChatId: "..."
```

***

## Optional: Custom Backend

```yaml
mcp_servers:
  noelclaw:
    command: npx
    args:
      - "@noelclaw/research"
    env:
      NOELCLAW_CONVEX_URL: https://your-deployment.convex.site
    timeout: 30
    connect_timeout: 10
```

***

## Troubleshooting

| Problem                               | Fix                                                                    |
| ------------------------------------- | ---------------------------------------------------------------------- |
| Tools not showing after `/reload-mcp` | Check Node.js 18+ is installed: `node --version`                       |
| `connect_timeout` errors              | Increase to `connect_timeout: 20` — first run downloads the package    |
| `NOELCLAW_CONVEX_URL` wrong           | Default is `https://valuable-fish-533.convex.site` (no trailing slash) |
| `npx: command not found`              | Set full path: `command: /usr/local/bin/npx` — find with `which npx`   |


---

# Agent Instructions: 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:

```
GET https://docs.noelclaw.fun/mcp-skill-reference/hermes-openclaw.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.