Skip to content
AIZona
AIZONA ADK · Public API

Build agent teams.
Ship fast.

REST API · MCP JSON-RPC · TypeScript SDK · CLI workflow. Metered AIZ credits with approval gates — no runaway spend.

Get API KeyOpenAPI Spec

From install to deploy.

Quick Start

CLI workflow — requires @aizona/adk-cli installed globally

01 · Install the CLI

# Install the CLI globally
npm install -g @aizona/adk-cli
# or with pnpm:
pnpm add -g @aizona/adk-cli

02 · Run Quick Start commands

# Initialize a new ADK project
aizona init --template basic

# Start the local dev server
aizona dev

# Create a new agent
aizona agent create my-agent

# Test your agent
aizona agent test ./agents/my-agent.ts -i "Hello!"

# Deploy to the platform
aizona agent deploy ./agents/my-agent.ts

API endpoint:/api/adk/v1(Next.js) orhttp://localhost:3456/v1(standalone)

OpenAPI spec:/api/adk/v1/openapi.json

MCP JSON-RPC:POST to /api/mcp with {"jsonrpc":"2.0","id":1,"method":"tools/list"} — or use the REST compatibility endpoint /api/mcp/tools/list.

TypeScript-first SDK.

SDK Usage

Use the ADK programmatically from TypeScript

import { defineAgent, Runner } from "@aizona/adk";

const agent = defineAgent({
  name: "my-agent",
  instructions: "You are a helpful assistant.",
});

const runner = new Runner({ provider: myProvider });
const result = await runner.run(agent, { input: "Hello!" });
console.log(result.output);
console.log(result.usage.totalCostUsd);