---
updatedAt: 2026-03-02T06:50:11.000Z
agentTools:
  projectIndex: https://neutronpay.readme.io/llms.txt
---

# Quick Start

Get Neutron MCP running with your AI client in under 2 minutes.

## Prerequisites

* **Node.js 18+** installed
* **Neutron API credentials** — get them from your [Neutron portal](https://portal.neutron.me)
  * API Key
  * API Secret

## Install

No install needed — use `npx` to run directly:

```bash
npx neutron-mcp
```

Or install globally:

```bash
npm install -g neutron-mcp
```

## Configure Your AI Client

### Claude Desktop

Add to your Claude Desktop config file:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
**Linux:** `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "neutron": {
      "command": "npx",
      "args": ["neutron-mcp"],
      "env": {
        "NEUTRON_API_KEY": "your-api-key",
        "NEUTRON_API_SECRET": "your-api-secret"
      }
    }
  }
}
```

Restart Claude Desktop after saving.

### Cursor

Add to `.cursor/mcp.json` in your project root:

```json
{
  "mcpServers": {
    "neutron": {
      "command": "npx",
      "args": ["neutron-mcp"],
      "env": {
        "NEUTRON_API_KEY": "your-api-key",
        "NEUTRON_API_SECRET": "your-api-secret"
      }
    }
  }
}
```

### VS Code (Copilot)

Add to your VS Code settings or `.vscode/mcp.json`:

```json
{
  "mcpServers": {
    "neutron": {
      "command": "npx",
      "args": ["neutron-mcp"],
      "env": {
        "NEUTRON_API_KEY": "your-api-key",
        "NEUTRON_API_SECRET": "your-api-secret"
      }
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "neutron": {
      "command": "npx",
      "args": ["neutron-mcp"],
      "env": {
        "NEUTRON_API_KEY": "your-api-key",
        "NEUTRON_API_SECRET": "your-api-secret"
      }
    }
  }
}
```

### Claude Code (CLI)

```bash
claude mcp add neutron -- npx neutron-mcp \
  -e NEUTRON_API_KEY=your-api-key \
  -e NEUTRON_API_SECRET=your-api-secret \
```

### OpenClaw

Add to your OpenClaw config:

```json
{
  "mcp": {
    "servers": {
      "neutron": {
        "command": "npx",
        "args": ["neutron-mcp"],
        "env": {
          "NEUTRON_API_KEY": "your-api-key",
          "NEUTRON_API_SECRET": "your-api-secret",
        }
      }
    }
  }
}
```

## Verify It Works

Once configured, ask your AI client:

> "Authenticate with Neutron and show my account info"

You should see your account details including display name, status, and country.

Then try:

> "Show my wallet balances"

If you see your BTC/USDT balances, you're all set! 🎉

## Environment Variables

| Variable             | Required | Description             |
| -------------------- | -------- | ----------------------- |
| `NEUTRON_API_KEY`    | ✅        | Your Neutron API key    |
| `NEUTRON_API_SECRET` | ✅        | Your Neutron API secret |

> **Note:** You do not need to configure an account ID. Your account ID (starting with `ne01-`) is returned automatically when the MCP server authenticates.

> **Note:** Authentication is automatic — the MCP server authenticates on first tool call and refreshes tokens as needed. You only need to call `neutron_authenticate` if you want to explicitly verify your credentials.

## Troubleshooting

### "Tool not found" or no tools showing

* Make sure Node.js 18+ is installed: `node --version`
* Check that `npx neutron-mcp` runs without errors in your terminal
* Restart your AI client after config changes

### Authentication errors

* Verify your API key and secret are correct
* Your account ID (starting with `ne01-`) is returned automatically when the MCP server authenticates — you don't need to configure it
* Ensure there are no extra spaces in the env values

### Connection issues

* The MCP server connects to `api.neutron.me` — ensure your network allows HTTPS outbound
* If behind a proxy, set `HTTPS_PROXY` in the env block

## Next Steps

* [Tools Reference](/reference/mcp-tools) — Detailed docs for all 18 tools
* [Neutron MCP Overview](/reference/mcp-overview) — What MCP is and how it works