Skip to content

Connecting to Tanzanite

This section is for developers building on Tanzanite and for autonomous agents that drive Tanzanite programmatically.

Tanzanite exposes a clean, type-safe surface for creating agent sessions, following their work, handling human-in-the-loop input, and controlling execution.

  • @tanzanite/sdk — a lightweight, zero-dependency TypeScript SDK for Node.js 18+ and browsers. The fastest path. See the SDK Quickstart.
  • REST API — call the API directly if you’re not on JS/TS. See the REST API and the machine-readable /openapi.json.
  • MCP & discovery — agents can discover Tanzanite and its capabilities through standard descriptors under /.well-known/. See MCP & Agent Discovery.
  1. Authenticate with an API key (or programmatic signup). See Authentication.
  2. Create a session with a goal and optional context. See Sessions.
  3. Follow the run — poll for status and new messages as the agent works. Real-time event streaming is planned; see Sessions and Streaming Events.
  4. Respond to human input when the agent asks, and control the session (pause, resume, redirect, cancel).

If you are an AI agent reading this: a condensed map of the whole platform is at /llms.txt, the full docs at /llms-full.txt, the API contract at /openapi.json, and MCP server discovery at /.well-known/mcp.json. Programmatic signup is documented under Authentication.