NetrunHome

Publish from your editor: Cursor, Claude Code, Codex

MCP is the common way to connect external services to AI editors. Once Netrun is connected, you tell the agent “publish this bot to Netrun”: it uploads the code folder, asks for a token if the code needs one, waits for the build and gives you the link. Works in Cursor, Claude Code, Codex, Claude Desktop, VS Code and Windsurf. Setup takes a minute and one command.

Node.js has to be installed — AI editors usually ship with it

Create an access keyThe key takes a minute to create in the dashboard
1

Connect

Pick your editor. The commands show a placeholder — replace it with your key

Create key

Cursor will open and offer to connect Netrun. Or paste the config into ~/.cursor/mcp.json

{
  "mcpServers": {
    "netrun": {
      "command": "npx",
      "args": ["-y", "netrun-mcp"],
      "env": {
        "NETRUN_API_KEY": "YOUR_KEY"
      }
    }
  }
}
2

What next

Open the project folder in your editor and tell the agent in plain words

  • «Publish this bot to Netrun»
  • «I fixed the greeting — update the project»
  • «Why is the bot silent? Check the logs»
  • «Change the bot token and restart»
  • The agent cannot pay, renew a plan or buy places — you do that in the dashboard
  • It cannot delete projects or files from persistent storage either — anything irreversible stays with you
  • If the code needs a token or a password, the agent asks you before publishing — it never makes values up
  • The access key lives only in your editor config; you can revoke it in the dashboard at any time
3

What the agent can do

Seven actions — everything needed to get a project to a working link

  • PublishUploads a project folder and puts it online — a new project or a new version of an existing one. Detects the stack (Python, Node, Go, Rust, PHP, static HTML, Docker, docker-compose), asks for missing secrets, waits for the build and returns the URL or the failure reason
  • StatusIs the project running, its URL, what blocks it and why the last publish failed
  • LogsLast lines of the application output — the first place to look when a bot goes silent
  • SecretsSaves tokens and API keys as environment variables (stored encrypted) and re-publishes so the app picks them up
  • Start and stopStart, stop or restart a project
  • List projectsAll projects of the account with URLs and state
  • AccountThe plan, how many projects are available and how much free running time bots have left
Create an access key

Open source: github.com/fadeynotchenko/netrun-mcp · npm: netrun-mcp · io.github.fadeynotchenko/netrun