# Roxyon

> Roxyon is an MCP server for developer tools. Build LumenJS apps and deploy them to Roxyon from an AI assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Repository:** https://github.com/bea-technology/roxyon-devtools/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.bea-technology/roxyon
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

The server lets an assistant read the LumenJS V1 reference and the BaaS and deploy docs as resources, write an app, then initialize and ship it to Roxyon infrastructure. Deployment is a two-step flow: roxyon_deploy returns a dry-run plan until confirm is set to true, at which point it builds, uploads, waits for the app to go live and reports the URL or the failure reason.

Every tool with side effects requires confirm: true. Authentication reuses the Roxyon CLI login, or a roxp_ personal access token in ROXYON_TOKEN for CI and headless use. The README describes stdio operation and says a remote OAuth transport was planned, while the registry also lists a hosted Streamable HTTP endpoint.

Two prompts, scaffold-lumen-app and deploy-to-roxyon, start common tasks.

## Features

- **Docs as resources:** Exposes LumenJS, BaaS and deploy references to the assistant.
- **Dry-run deploys:** roxyon_deploy only plans until confirm is true.
- **App status and logs:** Check status, read logs and restart an app.
- **Environment variables:** Read and set app environment values.
- **GitHub linking:** Link an app to a GitHub repository.
- **Prompts:** Scaffold a Lumen app or deploy to Roxyon.

## Good for

- Scaffold and deploy a LumenJS app from chat
- Inspect logs after a failed deploy
- Set environment variables for an app
- List domains and apps in a Roxyon account

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http roxyon https://mcp.roxyon.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.roxyon.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "roxyon": {
      "url": "https://mcp.roxyon.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "roxyon": {
      "type": "http",
      "url": "https://mcp.roxyon.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "roxyon": {
      "serverUrl": "https://mcp.roxyon.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "roxyon": {
      "type": "http",
      "url": "https://mcp.roxyon.com/mcp"
    }
  }
}
```

## Tools

- `roxyon_whoami`: Shows the logged-in identity.
- `roxyon_list_domains`: Lists domains.
- `roxyon_list_apps`: Lists apps.
- `roxyon_init`: Writes roxyon.json for a directory.
- `roxyon_deploy`: Plans or performs a deploy.
- `roxyon_app_status`: Reports app status.
- `roxyon_logs`: Reads app logs.
- `roxyon_restart`: Restarts an app.
- `roxyon_env_get`: Reads environment values.
- `roxyon_env_set`: Sets environment values.
- `roxyon_link_github`: Links an app to GitHub.

## FAQ

### How do I authenticate?

Run roxyon login with the CLI, or set ROXYON_TOKEN to a roxp_ personal access token.

### Can it deploy without confirmation?

No. Side-effecting tools need confirm: true, and deploy is a dry run otherwise.

### Which clients work?

Claude Code, Cursor, Windsurf, Cline and Gemini CLI use the same npx configuration.

### How do I add Roxyon to Claude Code?

Run this command in your terminal: claude mcp add --transport http roxyon https://mcp.roxyon.com/mcp

### What are the best alternatives to Roxyon?

The closest alternatives to Roxyon are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/roxyon
