---
title: Synorb SDK Documentation
description: Synorb REST, MCP, CLI, and SDK guidance for agent developers.
canonical: https://synorb.com/sdk
last-updated: 2026-09-16
---

# Synorb SDK Documentation

Choose the client surface that matches the job. The current Synorb contract
uses one Bearer **Synorb Key** for REST and MCP.

## Current client surfaces

- [Synorb OpenAPI Specification](https://synorb.com/openapi.json) — generate a
  typed REST client for any supported language.
- [Synorb MCP Server Documentation](https://synorb.com/docs/mcp) — use the
  Streamable HTTP server for interactive agent sessions.
- [Synorb CLI Documentation](https://synorb.com/docs/cli) — install the
  official npm package with `npm install -g @synorb/cli`.
- [Synorb Authentication Documentation](https://synorb.com/auth) — provision
  and protect the single Synorb Key.

## Python and other languages

Synorb does not currently publish a separate first-party Python REST SDK.
Generate a client from the [Synorb OpenAPI Specification](https://synorb.com/openapi.json)
or use the documented REST/MCP contracts. The repository `sdk/` package is a
legacy, source-only sync-ontology helper and is not the current Synorb Key
client.

## When to use each surface

Use MCP for interactive discovery and reasoning, REST/OpenAPI for deterministic
server-side jobs, and the CLI for local scripts or agent shells. Start with the
[Synorb Developer Portal](https://synorb.com/developer), provision a key at
[/connect](https://synorb.com/connect), and validate request scope through the
[zero-quota sandbox/test path](https://synorb.com/sandbox).