Bugnet
Get Started
Start

Install

Bugnet is one MCP server at https://mcp.bugnet.sh/mcp. It speaks Streamable HTTP and needs no sign-in, header or API key. By installing Bugnet you accept the Terms.

Pick an entry#

Every client takes one of two entries.

EntryPaysNeeds
The URL, https://mcp.bugnet.sh/mcpBy link, in your browserNothing else
The bridge, npx -y @bugnet/mcp@0.1.0From the pay.sh wallet or a wallet file on this computer, or by link without themNode 20.19.3 or newer, plus pay (opens in a new tab) or a wallet file to pay from this computer

Warning

Add one entry, not both, or every tool shows up twice.

Clients#

Claude Code#

The plugin#

The plugin adds the MCP server, a skill that tells Claude when a sandbox fits, and hint hooks. It comes in two forms. Install one, not both, or every tool shows up twice.

claude plugin marketplace add bugnet-sh/bugnet
claude plugin install bugnet@bugnet          # pays by link, in your browser
claude plugin install bugnet-wallet@bugnet   # pays from the pay.sh wallet on this computer
  1. Add the marketplace with claude plugin marketplace add bugnet-sh/bugnet.
  2. Install bugnet@bugnet to pay by link, or bugnet-wallet@bugnet to pay from the pay.sh wallet.
  3. Start a new Claude Code session.
  • bugnet connects to https://mcp.bugnet.sh/mcp and needs nothing else.
  • bugnet-wallet runs the bridge with npx, so it needs Node 20.19.3 or newer, and pays with pay (opens in a new tab) set up on this computer.
  • Start Claude Code as plain claude, never pay claude, which loads only pay's own server and hides Bugnet.

Inside a session, /plugin marketplace add bugnet-sh/bugnet and then /plugin install bugnet@bugnet do the same. The tools show up as mcp__plugin_bugnet_sandbox__bugnet_*, or mcp__plugin_bugnet-wallet_sandbox__bugnet_* with the wallet plugin.

The hooks run a small local script with Node and stay silent if Node is not installed. They add a short hint when a prompt or a command looks like a fit, for example after a local run fails for lack of CUDA, memory or disk space. The hints are computed on your machine and send nothing anywhere. Set BUGNET_HINTS=quiet to keep only hints after failed commands, or BUGNET_HINTS=off to turn hints off.

Just the MCP server#

claude mcp add --transport http bugnet https://mcp.bugnet.sh/mcp

Without --scope, Bugnet works only in the folder where you ran the command. Add --scope user to have it in every project, for you only:

claude mcp add --scope user --transport http bugnet https://mcp.bugnet.sh/mcp

Or add --scope project to share it with your team through .mcp.json. Check it with claude mcp list, which should show bugnet: https://mcp.bugnet.sh/mcp (HTTP) - ✔ Connected.

claude.ai#

  1. Open Customize > Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it Bugnet and enter https://mcp.bugnet.sh/mcp as the URL. Click Continue, and Continue again on the detected settings.
  4. Under Authentication, choose No sign in. Click Add.
  5. In a chat, click + at the lower left, then Connectors, and turn Bugnet on.

On Team and Enterprise plans an owner adds it first under Organization settings > Connectors, then each member connects it. The Free plan allows one custom connector.

claude.ai runs in your browser, so it cannot use the bridge. It pays by link: the agent shows you the order's pay link, you pay in your browser, and the agent finishes the order with bugnet_redeem.

Claude Desktop#

  1. Download bugnet.mcpb from the latest release (opens in a new tab).
  2. Open it with Claude Desktop.
  3. Confirm the install when Claude Desktop asks.

It runs the bridge, so it pays from the pay.sh wallet on this computer when you have one, and by link otherwise.

Cursor#

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project:

{
    "mcpServers": {
        "bugnet": {
            "url": "https://mcp.bugnet.sh/mcp"
        }
    }
}

To pay from the pay.sh (opens in a new tab) wallet on this computer, use the bridge entry instead of the URL one:

{
    "mcpServers": {
        "bugnet": { "command": "npx", "args": ["-y", "@bugnet/mcp@0.1.0"] }
    }
}

Cursor's docs do not say it reads MCP server instructions, so copy integrations/cursor/bugnet.mdc (opens in a new tab) to .cursor/rules/bugnet.mdc too. It tells the agent when to offer a sandbox.

VS Code#

Add this to .vscode/mcp.json in your workspace:

{
    "servers": {
        "bugnet": {
            "type": "http",
            "url": "https://mcp.bugnet.sh/mcp"
        }
    }
}

Or run MCP: Add Server from the Command Palette, pick HTTP, and enter the URL. To add it to your user profile from a terminal:

code --add-mcp '{"name":"bugnet","type":"http","url":"https://mcp.bugnet.sh/mcp"}'

To pay from the pay.sh (opens in a new tab) wallet on this computer, use the bridge entry instead of the URL one:

{
    "servers": {
        "bugnet": { "type": "stdio", "command": "npx", "args": ["-y", "@bugnet/mcp@0.1.0"] }
    }
}

Codex CLI#

To pay from the pay.sh (opens in a new tab) wallet on this computer, add the bridge:

codex mcp add bugnet -- npx -y @bugnet/mcp@0.1.0

Then give it more time in ~/.codex/config.toml, since a paid call waits while you approve the payment and the first start downloads the bridge:

[mcp_servers.bugnet]
command = "npx"
args = ["-y", "@bugnet/mcp@0.1.0"]
startup_timeout_sec = 30
tool_timeout_sec = 400

To pay by link in your browser instead, add the URL:

codex mcp add bugnet --url https://mcp.bugnet.sh/mcp

Or add it to ~/.codex/config.toml yourself:

[mcp_servers.bugnet]
url = "https://mcp.bugnet.sh/mcp"

codex mcp list shows it, and so does /mcp inside Codex. Through the URL every Bugnet tool answers within 45 seconds, inside Codex's default 60 second limit.

Devin Desktop#

Devin Desktop was formerly Windsurf. Add this to ~/.config/devin/mcp_config.json, or to .devin/mcp_config.json in your project:

{
    "mcpServers": {
        "bugnet": {
            "url": "https://mcp.bugnet.sh/mcp"
        }
    }
}

Then open Customize, click MCPs, and refresh the list. An older Windsurf takes the same entry in the file that Cascade's Open MCP config file opens.

Any MCP client#

SettingValue
URLhttps://mcp.bugnet.sh/mcp
TransportStreamable HTTP
Sign-inNone, no headers and no API key
Stdionpx -y @bugnet/mcp@0.1.0, needs Node 20.19.3

Most clients take one of these two shapes.

{
    "mcpServers": {
        "bugnet": { "url": "https://mcp.bugnet.sh/mcp" }
    }
}

If your agent reads AGENTS.md, paste integrations/agents-md/AGENTS.snippet.md (opens in a new tab) into it.

The bridge: npx @bugnet/mcp#

The bridge is a small program that runs on your computer. Your client talks to it over stdio, and it passes every call on to Bugnet's server unchanged, except that it pays or opens the pay link for a payment step. You only need it for these:

  • Paying from the pay.sh wallet on your computer. When a paid call needs a payment, the bridge has pay (opens in a new tab) pay it after you approve with Touch ID, then finishes the order. It pays only links on pay.bugnet.sh, on Solana mainnet, up to the price you approved.
  • Paying from a wallet file, with no extra confirmation, within limits you set. Before you pay sets it up.
  • Clients that only run local servers.

Without either, the bridge opens the pay link in your client when the client can open links, and waits up to 10 minutes for you to pay.

Use the bridge instead of the URL, not both, or every tool shows up twice. It needs Node 20.19.3 or newer.

claude mcp add --scope user --transport stdio bugnet -- npx -y @bugnet/mcp@0.1.0
Add Bugnet to Claude Code
{
    "mcpServers": {
        "bugnet": { "command": "npx", "args": ["-y", "@bugnet/mcp@0.1.0"] }
    }
}

The bridge reads ~/.config/bugnet/mcp.toml if it exists, or the file --config names. --gateway URL points it at another server. The settings file holds no secrets. Every setting with its default is in packages/bridge/config/example.toml (opens in a new tab).

Next steps#