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
  • 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 — Detailed docs for all 18 tools
• Neutron MCP Overview — What MCP is and how it works