SDK & MCP

TypeScript SDK

A typed client for Rytiv in TypeScript follows. Until it is published, the REST API is a few lines of fetch, and the MCP server gives your agent the same platform as tools.

What it will do

A typed client for the same API the CLI and the MCP server use: computers, sandboxes, apps, machines, deploys, databases and buckets, with errors you can branch on (code). It will read your key from RYTIV_TOKEN, like the CLI.

Until then: the REST API

Everything the SDK will do is a plain HTTP call today. A small helper is enough:

const API = process.env.RYTIV_ENDPOINT ?? "https://api.rytiv.app";

async function rytiv(path: string, init: RequestInit = {}) {
  const res = await fetch(`${API}/v1${path}`, {
    ...init,
    headers: {
      Authorization: `Bearer ${process.env.RYTIV_TOKEN}`,
      "Content-Type": "application/json",
      ...init.headers,
    },
  });
  const body = res.status === 204 ? null : await res.json();
  if (!res.ok) throw new Error(`${body?.code ?? res.status}: ${body?.error ?? res.statusText}`);
  return body;
}

const sandbox = await rytiv("/sandboxes", {
  method: "POST",
  body: JSON.stringify({ template: "app:web", ttlSeconds: 600 }),
});
const result = await rytiv(`/sandboxes/${sandbox.id}/exec`, {
  method: "POST",
  body: JSON.stringify({ cmd: ["node", "--version"] }),
});
console.log(result.stdout);
await rytiv(`/sandboxes/${sandbox.id}`, { method: "DELETE" });

The same in Python:

import os, requests

API = os.environ.get("RYTIV_ENDPOINT", "https://api.rytiv.app")
HEADERS = {"Authorization": f"Bearer {os.environ['RYTIV_TOKEN']}"}

def rytiv(method, path, **kwargs):
    res = requests.request(method, f"{API}/v1{path}", headers=HEADERS, **kwargs)
    if res.status_code == 204:
        return None
    body = res.json()
    if not res.ok:
        raise RuntimeError(f"{body.get('code', res.status_code)}: {body.get('error')}")
    return body

sandbox = rytiv("POST", "/sandboxes", json={"template": "app:web", "ttlSeconds": 600})
result = rytiv("POST", f"/sandboxes/{sandbox['id']}/exec", json={"cmd": ["node", "--version"]})
print(result["stdout"])
rytiv("DELETE", f"/sandboxes/{sandbox['id']}")

See REST API basics for the error format, and the API reference for every route with its fields.

MCP

The MCP server at https://api.rytiv.app/v1/mcp is the SDK your coding agent uses today: eleven tools for apps, logs, secrets, Postgres and computers, each with annotations your client can use to decide what to confirm. See MCP tools and the quickstart.