Tutro developers

Build on Tutro.

One REST API, one MCP server, one credit balance. Drop your API key into a curlcall, the official TypeScript SDK, or any MCP-compatible AI client — it all hits the same pipelines that power tutro.ai. Every call bills against your regular credits; there's no separate developer plan.

Quickstart

Your first call

Once you have a key from Settings → Developer, every endpoint lives under https://app.tutro.ai/api/v1. Authenticate with a bearer token:

bash
curl https://app.tutro.ai/api/v1/credits \
  -H "Authorization: Bearer tutr_xxx"
TypeScript SDK

@tutro/sdk

Zero-dependency wrapper around fetch. Works on Node 18+, Deno, Bun, and the browser.

bash
npm install @tutro/sdk
ts
import { TutroClient } from "@tutro/sdk";

const tutro = new TutroClient({ apiKey: process.env.TUTRO_API_KEY! });

// Kick off a lesson
const { lessonId } = await tutro.lessons.create({
  topic: "Photosynthesis in plants",
  gradeLevel: "5",
});

// Poll until it's ready
while (true) {
  const { lesson } = await tutro.lessons.get(lessonId);
  if (lesson.status === "ready") break;
  await new Promise((r) => setTimeout(r, 3000));
}
MCP

Wire Tutro into Claude, Cursor, or any MCP client

Tutro ships a native Model Context Protocol server. Drop this into your MCP config and your AI client can create lessons, list your learners, and check your balance as tool calls — entirely through natural language.

json
{
  "mcpServers": {
    "tutro": {
      "url": "https://app.tutro.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer tutr_xxx"
      }
    }
  }
}

Exposed tools: list_lessons, get_lesson, create_lesson, list_learners, credits_balance.

Reference

REST endpoints

GET/api/v1/credits
Returns the API key owner's current credit balance.
GET/api/v1/lessons?limit=20
Lists the caller's lessons (newest first).
POST/api/v1/lessons
Body: { topic, gradeLevel, subject?, learnerId? }. Kicks off a lesson and returns the id. Requires ~200 credits to start; actual usage is metered per asset.
GET/api/v1/lessons/:id
Fetches a single lesson with its full plan.
GET/api/v1/learners
Lists learners in the caller's family.
Billing

One balance, metered per asset

API and MCP calls don't have a separate plan. Every credit-consuming operation (LLM tokens, image generation, TTS, video render) bills the API key owner's balance at the same per-unit rates the web app uses. Free operations (listing lessons, checking balance) stay free. Top up or upgrade from Settings → Billing.

Something missing?

We ship endpoints on demand. Email us at api@tutro.ai with what you're trying to build.