NovaOS MCP
Field guides

Everything the copilot knows

Official docs plus lessons from apps built on NovaOS. The same guides power novaos_docs inside your AI app.

NovaOS overview and glossary

What NovaOS is, the IDs you will meet, and how this MCP server's tools are organized.

Setting up a computer for NovaOS

Install Python, Docker, novaos-cli and the SDK on macOS, Linux or Windows; version matrix and install pitfalls.

Environments, sign-in, organizations and scopes

How novaos-cli resolves environments, how sign-in works, org context, roles, token scopes and the traps around them.

Building agents with the Python SDK

AgentBuilder, the one-skill rule, SkillResult statuses, progress and heartbeats, turn budgets, LLM/MCP/RAG calls inside an agent, manifest v2.0 and Dockerfile rules.

MCP tool servers on NovaOS

Building, naming, publishing and activating MCP servers that agents call through the NovaOS MCP gateway; the read/write name classifier and -32042.

Knowledge base: RAG, parsers, GraphRAG

Collections, parsing, ingest, search vs query, GraphRAG, limits and the RAG quirks that bite in production.

Publish, review, approval, installation and instances

From a local agent to a running instance: publish flow, review states, platform-admin approval, deployment targets, user vs service-account installs, versions and release order.

Service accounts and calling agents from an app backend

Creating and rotating service accounts, scopes, token minting, run-as-user vs service account, capacity limits and the backend integration pattern.

Runs, events and streaming

Execute, event stream, run states, stream cuts and recovery, threads, input limits and what callers actually see.

Chat, memory and databases

Conversation management, NovaOS Memory (and why apps keep their own), app databases with org isolation, and where state may live.

LLM gateway and models

Calling models through NovaOS: model ids, scopes, fallbacks, cost headers, rate limits, grounded web search, thinking tokens, and the prompt-injection filter.

Testing, evaluation, observability and metering

Local tests, eval suites, post-publish smoke tests, logs and traces, cost per run and org spending.

Troubleshooting by symptom

Symptom -> cause -> fix for the failures people actually hit with NovaOS. Use novaos_explain_error for any error text.

Known NovaOS platform issues and gaps (Nov 2026)

Platform-side limitations and bugs observed in production apps, with workarounds. Check before reporting a "new" bug.