Deploy with an AI agent

naro is built to be driven from a terminal, and that includes an agent's terminal. One URL teaches an agent to deploy; an MCP server hands it the whole lifecycle as tools.

Point an agent at one URL

naro.sh/llms.txt is plain text written for machines. An agent that fetches it learns the commands, the JSON contract and the error codes with nothing installed and no prior knowledge of naro.

naro.sh/llms.txt

Or paste this prompt

Hand this to any terminal-capable agent. It stays in English in every language of these docs on purpose — it is input for a model, not prose for a reader.

Help me deploy this project to naro. Read https://naro.sh/llms.txt first, then:
1. Run `npx naro-cli login` if I am not signed in.
2. Deploy a preview with `npx naro-cli deploy` and show me the URL.
3. If the build fails, read the logs with `npx naro-cli logs --type build`, fix the code, and try again.
4. Once I confirm the preview, ship it with `npx naro-cli deploy --prod`.

Model Context Protocol

For natural-language control — "deploy this project to naro" — add the MCP server. It shares the session from naro login, so there is no second sign-in.

Claude Code

Cursor and other MCP clients

{
  "mcpServers": {
    "naro": { "command": "npx", "args": ["-y", "naro-mcp"] }
  }
}

What the MCP server exposes

The same surface as the CLI, grouped below.

Account and projects

whoamilist_teamslist_projectsget_projectlink_project

Deployments

deploylist_deploymentsget_deploymentpromote_deploymentrollback_deploymentcancel_deployment

Logs

get_build_logsget_runtime_logs

Environment variables

list_environment_variablesset_environment_variableremove_environment_variable

Domains

list_domainsadd_domainverify_domainremove_domain

Git

connect_git_repositorydisconnect_git_repository

Database

enable_databaseget_databaselist_tablesexecute_sqlapply_migrationcreate_tablealter_tabledrop_tablecreate_indexdrop_indexlist_migrationsgenerate_typescript_typesexport_databaserestore_database

Speed Insights and Analytics

get_speed_insightsset_speed_insightsget_analytics

Preview protection

get_preview_protectionset_preview_protection

Storage

get_storageenable_storagelist_storage_bucketscreate_storage_bucketupdate_storage_bucketdelete_storage_bucket

CI and headless agents

naro login opens a browser. Where there is none, mint a token and pass it as NARO_TOKEN.

Machine-readable output

Every command accepts --json (one JSON object on stdout, logs on stderr) and --yes (never prompt). Failures return a stable code — the CLI reference lists them.