NovaOS MCP
NovaOS MCP · v0.1.0

Build on NovaOS by talking to your AI.

Connect your AI app to one URL. It takes you from an empty laptop to a published, tested NovaOS agent.

MCP endpointhttps://novaos-mcp-d.poc.us.orbitronai.com/mcpConnect

Default environment: US staging. Ask switch NovaOS to FDE to move. Sign-in uses novaos-cli in your browser. Local steps need Node.js 20 or newer.

01

Connect

Pick your AI app.

Recommended · skills and server in one
  1. Add the NovaOS marketplace in Claude Code:
    /plugin marketplace add https://novaos-mcp-d.poc.us.orbitronai.com/marketplace.json
  2. Install the plugin:
    /plugin install novaos@orbitron-novaos
  3. Run /reload-plugins, then ask Use NovaOS: start here.

Type /novaos for the playbooks and @novaos: for the guides. Use the plugin or the server, not both. If you added the server with claude mcp add, remove it:

claude mcp remove novaos

  1. Open Customize > Connectors > Add custom connector.
  2. Name it NovaOS and paste the URL:
    https://novaos-mcp-d.poc.us.orbitronai.com/mcp
  3. Start a chat and ask Use NovaOS: start here.

On Team and Enterprise plans an owner adds it in Organization settings > Connectors.

  1. Download novaos.mcpb (335 KB).
  2. Double-click it and click Install in Claude.
  3. Start a chat and ask Use NovaOS: start here.

Runs on your computer. Download again to update. SHA-256 acd4e3219be9760e...

  1. Add to ~/.codex/config.toml:
    [mcp_servers.novaos]
    url = "https://novaos-mcp-d.poc.us.orbitronai.com/mcp"
    tool_timeout_sec = 120
  2. Restart Codex and ask Use NovaOS: start here.
  1. Add to ~/.cursor/mcp.json:
    {
      "mcpServers": {
        "novaos": { "url": "https://novaos-mcp-d.poc.us.orbitronai.com/mcp" }
      }
    }
  2. Ask Use NovaOS: start here.
  1. Create .vscode/mcp.json in your project:
    {
      "servers": {
        "novaos": { "type": "http", "url": "https://novaos-mcp-d.poc.us.orbitronai.com/mcp" }
      }
    }
  2. In Copilot Chat agent mode, enable the novaos tools.
  1. Point any Streamable HTTP MCP client at:
    https://novaos-mcp-d.poc.us.orbitronai.com/mcp
02

Then ask

Start

"Use NovaOS: start here. I want my first agent."

Ship

"Publish my agent, then test it on NovaOS."

Debug

"This run failed: <run id>. Why?"

Switch env

"Switch NovaOS to FDE." Or "back to US staging."

03

What it covers

80 tools, 7 guided journeys, 7 skills. See Tools and Guides.

Set up any computer

Checks Python, Docker, Node and novaos-cli and installs what is missing on macOS, Linux and Windows.

5 tools

Sign in the right way

novaos-cli environments, browser sign-in, organizations, scopes. Catches the CLI's silent fallback to local.

9 tools

Build agents

Proven Python template, contract tests, a linter for about 30 NovaOS traps, agent card checks.

6 tools

MCP tool servers

Read-safe templates and NovaOS's exact read/write name rules, so user runs never hit -32042.

3 tools

Knowledge base

Collections, parser choice, robust ingest, search with the planner off, GraphRAG.

10 tools

Publish and approve

Pre-flight, publish, review status, the admin approval steps, version history.

6 tools

Install and instances

Install for yourself or a service account and get the right instance id.

3 tools

Connect a backend

Safe credential files, token and scope tests, generated Python and TypeScript clients.

5 tools

Run and chat

Start runs, stream, wait without re-running, keep conversation history.

5 tools

Conversations and approvals

Platform conversations and native human-in-the-loop decisions.

5 tools

Test on NovaOS

No local NovaOS testing: publish, install, then run a test suite as real NovaOS runs.

3 tools

Cost and usage

Org cost by agent, model and service account, and cost per run.

2 tools

Models

Model directory, served-model checks, cost estimates.

1 tool

Diagnose anything

Run diagnosis, logs, error explanations and ready-to-file bug drafts.

6 tools

Escape hatches

Any novaos-cli command or NovaOS API call, with errors explained.

2 tools