# Add to Cursor / Windsurf

No build step needed. The Noelclaw MCP server runs via `npx @noelclaw/research`.

***

## Cursor

### Via Settings UI

1. Open Cursor → **Settings** (Ctrl+, / Cmd+,)
2. Search for **MCP** or go to **Features → MCP**
3. Add a new server:
   * **Name:** `noelclaw`
   * **Command:** `npx`
   * **Args:** `@noelclaw/research`

### Via Config File

Edit `~/.cursor/mcp.json` (create it if it doesn't exist):

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

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

### Use in Cursor Composer

Open Composer (Cmd+I / Ctrl+I), enable Agent mode, then:

```
use noelclaw to get the current crypto market
ask noel what the best DeFi opportunities are right now
get the latest BTC signal from noelclaw
```

***

## Windsurf

Edit `~/.windsurf/mcp_config.json`:

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

Restart Windsurf.

***

## Optional: Custom Backend

```json
{
  "mcpServers": {
    "noelclaw": {
      "command": "npx",
      "args": ["@noelclaw/research"],
      "env": {
        "NOELCLAW_CONVEX_URL": "https://your-deployment.convex.site"
      }
    }
  }
}
```

***

## Troubleshooting

| Problem                  | Fix                                                                        |
| ------------------------ | -------------------------------------------------------------------------- |
| Tools not showing        | Restart Cursor/Windsurf after saving config                                |
| `npx: command not found` | Install Node.js 18+ from nodejs.org                                        |
| Connection timeout       | Normal on first run — `npx` downloads the package. Retries will be instant |


---

# 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/cursor-install.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.