Developers & agents

Norbelys API & developer portal

Everything the Norbelys dashboard does is available through the Norbelys REST API, OpenAPI spec, MCP server, official SDKs and CLI — built to be driven by people and AI agents alike.

Norbelys API documentation

Guides, quickstart and the full Norbelys REST API reference with code samples.

Norbelys OpenAPI 3.1 spec

The complete, typed OpenAPI description of the Norbelys REST API — 83 operations.

Norbelys REST API

Base URL https://api.norbelys.com/v1 — bearer auth, cursor pagination, typed errors.

Norbelys MCP server

Drive Norbelys from Claude, Cursor and other agents over Streamable HTTP (Model Context Protocol).

Norbelys SDKs

Official SDKs: @norbelys/sdk (npm), norbelys (PyPI), Go and Ruby — all generated from the OpenAPI spec.

Norbelys CLI

The norbelys CLI on npm — `npm i -g norbelys`, or curl -fsSL https://cli.norbelys.com/install | sh.

Norbelys agent authentication

API keys and OAuth 2.1 discovery for autonomous agents (auth.md).

Norbelys agent kit (GitHub)

AGENTS.md, agent skills and Cursor rules — how AI agents should use Norbelys.

Authentication

Headless and CI callers use anorg-scoped API key(ak_…) created in the app, sent asAuthorization: Bearer ak_…. Interactive agents can register via OAuth 2.1 using the metadata at/.well-known/oauth-protected-resource. See auth.md for the full walkthrough.

Command-line

Install the norbelys CLI:

curl -fsSL https://cli.norbelys.com/install | sh

Ask Norbelys

Search the product, docs and blog in natural language. This form is also exposed to in-browser AI agents (WebMCP).