Para agentes de IA y quienes los desarrollan

TutorFlow Agent Platform

Una API y un servidor MCP para que tu agente cree cursos y corrija respuestas
Se registra solo y paga por acción.

Registra tu agente Lee la documentación

Llamada a la API

<3s

Evaluación promedio

40+

Idiomas

Campos de comentarios

Empieza

Las primeras cuatro llamadas de tu agente

Abre los pasos de uno en uno. El paso 1 define TUTORFLOW_KEY y CLASSROOM_ID, que usan todos los demás.

Necesita curl y jq. Cambia el slug y el correo antes de ejecutarlo.

1Registrar el agente

Una sola llamada, sin clave. La respuesta trae contentApiKey, defaultClassroomId y 50 créditos de prueba. La clave se muestra una sola vez, así que guárdala.

bash

RESPONSE=$(curl -s -X POST https://api.tutorflow.io/v1/platform/agent/register \
  -H "Content-Type: application/json" \
  -d '{"name":"My Agent","slug":"my-agent-2048","email":"you@example.com"}')
export TUTORFLOW_KEY=$(echo "$RESPONSE" | jq -r .contentApiKey)
export CLASSROOM_ID=$(echo "$RESPONSE" | jq -r .defaultClassroomId)

2Generar un curso

TutorFlow genera el curso en segundo plano y responde con un 202 y un runId. Un curso de una lección cuesta 6 créditos.

bash

RUN_ID=$(curl -s -X POST \
  "https://api.tutorflow.io/v1/content/classrooms/$CLASSROOM_ID/courses/generate" \
  -H "Authorization: Bearer $TUTORFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic":"Fractions for grade 4","lessonCount":1}' | jq -r .runId)

3Consultar el progreso

Consulta la generación cada 20 o 30 segundos hasta que status sea completed o failed. Cuando termina, resourceId trae el ID del curso nuevo.

bash

curl -s "https://api.tutorflow.io/v1/content/classrooms/$CLASSROOM_ID/runs/$RUN_ID" \
  -H "Authorization: Bearer $TUTORFLOW_KEY" | jq '{status, resourceId, error}'

4Corregir una respuesta

La corrección llega al instante, con una calificación, los puntos fuertes y sugerencias de mejora. Cada una cuesta 1 crédito.

Solicitud

bash

curl -s -X POST "https://api.tutorflow.io/v1/content/classrooms/$CLASSROOM_ID/evaluations" \
  -H "Authorization: Bearer $TUTORFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "evaluationType": "open_ended",
    "questionText": "Explain photosynthesis",
    "learnerAnswer": "Plants use sunlight to convert CO2 and water into glucose.",
    "maxScore": 10,
    "language": "en",
    "learnerExternalId": "learner-42"
  }'

Respuesta

json

{
  "id": "5023...",
  "status": "COMPLETED",
  "evaluationType": "open_ended",
  "learner": { "externalId": "learner-42", "name": null },
  "score": 7,
  "maxScore": 10,
  "normalizedScore": 70,
  "strengths": ["Correctly identifies sunlight as key factor"],
  "suggestions": ["Mention the role of chlorophyll", "Explain the chemical equation"],
  "feedbackSummary": "Good foundational understanding. To improve, include the role of chlorophyll."
}

¿Prefieres la terminal? Usa la CLI

@tutorflow/cli hace las mismas llamadas. agent register guarda la clave en ~/.tutorflow/config.json, así que en los siguientes comandos ya no tienes que pasar la clave ni el aula.

bash

npm install -g @tutorflow/cli
tutorflow agent register --name "My Agent" --slug my-agent-2048 --email you@example.com
tutorflow course generate "Fractions for grade 4" --lessons 1 --wait
tutorflow evaluate --type open-ended --question "Explain photosynthesis" \
  --student-answer "Plants use sunlight to make glucose." --learner-id learner-42

Ver la guía de la CLI

Lo que hace tu agente

Lo que tu agente hace sin depender de nadie

Una sola clave de Content API sirve para REST, MCP y la CLI. REST da acceso a todo; MCP cubre el registro, la facturación, los cursos y la corrección.

Corrige respuestas de estudiantes

Envía una respuesta con una rúbrica o una respuesta modelo. La calificación, los puntos fuertes y las sugerencias vuelven en campos tipados.

Crea material didáctico

Inicia un curso, un examen, una presentación, un video o un módulo con una sola llamada y consulta el avance hasta que termine.

Úsalo como herramientas MCP

Añade la URL del servidor y una clave, y Claude Code o cualquier cliente MCP podrá usar TutorFlow como herramienta.

Registro sin intervención humana

Tu agente crea su propia cuenta y, en la misma respuesta, recibe una clave, un aula online y 50 créditos de prueba.

El costo de cada llamada, por adelantado

Cada acción descuenta un número fijo de créditos, a 2 centavos cada uno, de un solo saldo, y estimatedCredits te da el costo antes de que empiece la generación. Los límites de solicitudes llegan en los encabezados de la respuesta.

Una clave para cada tarea

Separa las claves de prueba de las de producción, define el alcance de cada una y rótalas. Una clave de prueba funciona en un aula online de prueba y no gasta créditos.

Aviso cuando termina el trabajo

Registra un webhook y recibe una solicitud firmada cuando termina una generación, el renderizado de un video o una corrección.

En el idioma que pida tu agente

El contenido y los comentarios llegan en el idioma que pida tu agente.

Servidor MCP

Pensado para agentes, no solo para personas.

Tu agente encuentra solo las herramientas de TutorFlow: registrarse, consultar el saldo, generar un curso, seguir su avance y corregir respuestas, sin escribir código HTTP.

Añade una entrada de servidor a la configuración de tu cliente MCP y se conectan Claude, Gemini o cualquier otro cliente MCP
Tu agente se registra solo y recibe una clave en la misma llamada
Si se le acaban los créditos, envía a una persona un enlace de pago o, donde x402 está activado, paga él mismo en USDC
Entradas tipadas: si una llamada falla, la respuesta explica por qué

Guía MCP Primeros pasos para agentes

Claude Code

json

// .mcp.json: add to your project root
{
  "mcpServers": {
    "tutorflow": {
      "type": "http",
      "url": "https://mcp.tutorflow.io/api/mcp",
      "headers": {
        "Authorization": "Bearer tf_content_..."
      }
    }
  }
}

MCP SDK

typescript

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'

const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.tutorflow.io/api/mcp'),
  {
    requestInit: {
      headers: { Authorization: 'Bearer tf_content_...' },
    },
  },
)

const client = new Client({ name: 'my-agent', version: '1.0.0' })
await client.connect(transport)

// Call tools directly
const result = await client.callTool('run_evaluation', {
  evaluationType: 'open_ended',
  questionText: 'Explain photosynthesis',
  learnerAnswer: 'Plants use sunlight to make glucose...',
})

Registro autónomo

json

// No auth needed: agents register themselves
POST https://api.tutorflow.io/v1/platform/agent/register

{
  "name": "My AI Tutor",
  "slug": "my-ai-tutor",
  "email": "agent@example.com",
  "agentIdentity": "claude-3-5-sonnet"
}

// Returns a Content API key and the classroom it works in
// { "contentApiKey": "tf_content_...", "defaultClassroomId": "...", "trialContentCredits": 50 }

Precios

Paga por lo que crea tu agente

Cada llamada se descuenta de un solo saldo de créditos de tu cuenta, a 2 centavos por crédito. Esta es la lista de precios actual con la que se cobra a tu agente.

Lo que creas	Créditos	Dólares estadounidenses
Un curso con su esquema y todas sus lecciones	3 créditos más 6 créditos por lección	0,06 US$ más 0,12 US$ por lección
Un módulo de lección	6 créditos por lección	0,12 US$ por lección
Un examen con preguntas de corrección automática	3 créditos por examen	0,06 US$ por examen
Una diapositiva de texto	1 crédito por página de texto	0,02 US$ por página de texto
Una diapositiva con imagen generada por IA	3 créditos por página con imagen	0,06 US$ por página con imagen
La narración de las escenas de un video	1 crédito por escena	0,02 US$ por escena
Renderizar un video en MP4	3 créditos por renderizado	0,06 US$ por renderizado
Un juego listo para jugar	41 créditos por juego	0,82 US$ por juego
Corregir una respuesta	1 crédito por solicitud	0,02 US$ por solicitud

Cómo funciona la facturación

Recarga desde USD 5 con tarjeta o con USDC en Base cuando hayas verificado tu correo.
Con una tarjeta registrada, el trabajo sigue cuando se acaban los créditos, y ese uso se cobra a la tarjeta.
Una cuenta nueva empieza con 50 créditos gratis.
Las claves de prueba funcionan en un aula online de prueba y no gastan créditos.

Leer la guía de precios

Todo listo para tu agente

Que tu agente cree hoy su primer curso

Regístralo por API, MCP o CLI. Los 50 créditos de prueba alcanzan para un primer curso y algunas respuestas corregidas.

Registra tu agente Lee la documentación