# Netrun

Netrun sends a project folder to its hosting service and returns a URL. Use it to publish a website or Telegram bot, then inspect its status and logs through your editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: netrun-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/netrun-io/netrun-mcp
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/netrun

## What it does

Connect the MCP server to an editor and ask the agent to publish a project. It uploads the folder, waits for the build, then returns the project URL or an explanation of the failure. It detects Python, Node, Go, Rust, PHP, static HTML and Docker projects. If the app needs secrets, the agent asks you for them.

Available tools cover publishing, status checks, logs, secret management and restarting projects. The package archives the folder while respecting `.gitignore`, then sends it to the Netrun API. Netrun handles the build and runtime.

Local setup requires Node.js and a `NETRUN_API_KEY`, which stays in the editor configuration. The agent cannot delete projects or persistent files; payments and plan renewals also stay in the Netrun dashboard.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.netrun.io/v1/mcp`
- Environment variables: `NETRUN_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http netrun https://api.netrun.io/v1/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env NETRUN_API_KEY=<NETRUN_API_KEY> --transport stdio netrun -- npx -y netrun-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add netrun --url https://api.netrun.io/v1/mcp
```

2. **Platform CLI**
```bash
codex mcp add netrun --env NETRUN_API_KEY=<NETRUN_API_KEY> -- npx -y netrun-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "netrun": {
            "url": "https://api.netrun.io/v1/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "netrun": {
            "command": "npx",
            "args": [
                "-y",
                "netrun-mcp"
            ],
            "env": {
                "NETRUN_API_KEY": "<NETRUN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "netrun": {
            "type": "http",
            "url": "https://api.netrun.io/v1/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "netrun": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "netrun-mcp"
            ],
            "env": {
                "NETRUN_API_KEY": "<NETRUN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http netrun https://api.netrun.io/v1/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e NETRUN_API_KEY=<NETRUN_API_KEY> netrun npx -y netrun-mcp
```
Replace <…> with your own values

## When to use it
- publish a project folder and get its URL
- update an app that is already online
- find out why a bot stopped responding
- save an app token as an environment variable and restart the project
- check project status and URLs

## Example prompts
- Publish this website through Netrun and send me its URL.
- Check the Netrun logs for this bot and explain why it stopped responding.
- Update the Netrun project with the new token, then restart it.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
