Norano API

Overview

Point an agent at Norano: the agent-first API, the MCP server, and how to start.

Norano turns floor plans into branded plans, photorealistic visualizations, and 3D tours. This API is built for machines: an autonomous agent can discover the product, drive it, and recover from its own errors with no human in the loop.

Point an agent at the MCP server

Norano runs a remote MCP server (Streamable HTTP). Add it to any MCP-capable assistant — ChatGPT, Claude, or your own host — with an API key as the bearer token. The server only exposes the tools your key’s scopes allow.

https://mcp.norano.ai/mcp

Host config

{
  "mcpServers": {
    "norano": {
      "type": "http",
      "url": "https://mcp.norano.ai/mcp",
      "headers": {
        "Authorization": "Bearer norano_sk_live_…"
      }
    }
  }
}

Point an agent here

Every docs page is available as raw Markdown — append .md to the URL, or send Accept: text/markdown. Use the “Use with an agent” menu on any page to copy it or open it in ChatGPT / Claude.

Design principles

  • Machine-first — stable codes, enums, and ids are the contract; prose is not.
  • Async-native — expensive work returns a Job handle immediately; you poll or receive a webhook (see async jobs).
  • Discoverable — from only the base URL you can find the schema, the MCP server, and the auth scheme.
  • Idempotent — every unsafe POST takes an Idempotency-Key, so a retry never double-charges.
  • Every error is actionable — each error carries code, remediation, retryable, and docs_url (see errors).
  • Safe for autonomous spenders — cost is knowable before spending (dry_run), bounded (per-key caps), and rehearsable for free (test-mode keys).

Start here