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/mcpHost config
{
"mcpServers": {
"norano": {
"type": "http",
"url": "https://mcp.norano.ai/mcp",
"headers": {
"Authorization": "Bearer norano_sk_live_…"
}
}
}
}Point an agent here
OpenAPI 3.1
The single source of truth. Types, the SDK, and contract tests derive from it.
Interactive reference
Browse and try every endpoint, rendered from the OpenAPI document.
llms-full.txt
The whole-corpus, copy-paste-everything context blob for a single-shot load.
llms.txt
A curated, LLM-oriented map of what Norano does and where to look.
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, anddocs_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
Getting started
Base URL, get a key, your first call, and the discovery surface.
Authentication
Bearer keys, scopes, test vs live mode, and 401 discovery.
Async jobs
The unified Job object and the canonical agent loop.
Error catalog
Every code with its type, status, retryable flag, and remediation.
Webhooks
Signed event delivery and copy-paste verifiers.
Example agent flow
End to end — create, upload, poll, generate, webhook, fetch.