@velixir/mcp

Deploy web apps in any language to velixir, the European cloud, straight from your AI agent. deploy points at a source directory, packs the code, builds it with no Dockerfile, and returns a live URL plus a claim link the human opens to keep the app on a free, card-free account. logs fetches the build and runtime logs so the agent can debug what it shipped. No velixir account is needed.

Why

The agent generated a real backend. Now it has to run somewhere. velixir runs real apps in Node, Python, Go, Ruby, PHP, Java, Elixir, Rust, .NET, and more, with managed Postgres and Valkey, in the EU, with no egress fees. This server lets an agent one-shot deploy the app it just built, then hand the user a link to keep it.

Use it

Zero install, run with npx:

npx -y @velixir/mcp

Claude Desktop / Claude Code

Add to your MCP config:

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

Cursor / Cline / Windsurf

Point the editor's MCP settings at the same command (npx -y @velixir/mcp).

The deploy tool

| Input | Required | Description | | --- | --- | --- | | directory | yes | Absolute path to the app's source directory. | | name | no | Short name for the app; becomes part of the URL. | | language | no | node, python, go, ruby, php, java, elixir, rust, dotnet, deno, fsharp. Auto-detected if omitted. | | port | no | Only if the app hard-codes a port instead of reading the PORT env var. |

It returns the live URL, a claim URL (give this to the user), when the claim window closes, a deployment ID (pass it to logs), and a status URL to poll.

node_modules, .git, build output, and caches are skipped automatically. Nixpacks reinstalls dependencies and builds from source.

The logs tool

Fetch recent build and runtime logs for an app you deployed, so you can debug without an account: a failed build returns the build error, a running app returns its recent container output.

| Input | Required | Description | | --- | --- | --- | | deployment_id | yes | The deployment ID from the deploy response. | | tail | no | How many recent lines to fetch (default 200, max 1000). |

Works for unclaimed (agent-deployed) apps addressed by deployment ID. Once an app is claimed it moves to the owner's account; use the dashboard or the authenticated API for a claimed app's logs.

Config

| Env var | Default | Description | | --- | --- | --- | | VELIXIR_API_URL | https://velixir.net | Override for staging or self-host. |

Requirements

Node.js 18 or newer.