Se connecter
Pour les agents IA et ceux qui les développent

TutorFlow Agent Platform

Une API et un serveur MCP pour que votre agent crée des cours et corrige des réponses
Votre agent s'inscrit seul et paie à l'action.

Inscrire votre agentLire la documentation
1
Appel API
<3s
Évaluation moy.
40+
Langues
6
Champs de commentaires
Commencer

Les quatre premiers appels de votre agent

Ouvrez les étapes une par une. L'étape 1 définit TUTORFLOW_KEY et CLASSROOM_ID, utilisées dans toutes les étapes suivantes.

Nécessite curl et jq. Changez le slug et l'e-mail avant de l'exécuter.

1Inscrire l'agent

Un seul appel, sans clé. La réponse contient contentApiKey, defaultClassroomId et 50 crédits d'essai. La clé ne s'affiche qu'une seule fois, pensez à la conserver.

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)
2Générer un cours

TutorFlow rédige le cours en arrière-plan et répond 202 avec un runId. Un cours d'une leçon coûte 6 crédits.

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)
3Suivre la génération

Consultez l'état de la génération toutes les 20 à 30 secondes jusqu'à ce que status vaille completed ou failed. Une fois la génération terminée, resourceId contient l'identifiant du nouveau cours.

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

La correction arrive aussitôt, avec une note, les points forts et des pistes d'amélioration. Chaque correction coûte 1 crédit.

Requête

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"
  }'

Réponse

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."
}
Vous préférez le terminal ? Passez par la CLI

@tutorflow/cli effectue les mêmes appels. agent register enregistre la clé dans ~/.tutorflow/config.json : les commandes suivantes n'ont plus besoin de la clé ni de la classe.

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
Consulter le guide de la CLI
Ce que fait votre agent

Tout ce que votre agent fait sans demander à personne

Une seule clé Content API fonctionne avec REST, MCP et la CLI. REST donne accès à tout ; MCP couvre l'inscription, la facturation, les cours et la correction.

Corriger les réponses des apprenants

Envoyez une réponse avec une grille d'évaluation ou une réponse de référence. La note, les points forts et les suggestions reviennent dans des champs typés.

Créer des supports pédagogiques

Lancez un cours, un examen, des diapositives, une vidéo ou un module en un appel, puis suivez la génération jusqu'à la fin.

Utilisable comme outils MCP

Ajoutez l'URL du serveur et une clé : Claude Code ou tout autre client MCP peut alors utiliser TutorFlow comme outil.

Une inscription sans intervention humaine

Votre agent crée son propre compte et reçoit, dans la même réponse, une clé, une classe en ligne et 50 crédits d'essai.

Le coût de chaque appel, connu d'avance

Chaque action prélève un nombre fixe de crédits, à 2 cents l'unité, sur un seul solde, et estimatedCredits indique le coût avant le lancement. Les limites de débit figurent dans les en-têtes de réponse.

Une clé par usage

Séparez les clés de test et de production, limitez le périmètre de chacune et renouvelez-les. Une clé de test fonctionne dans une classe en ligne de test et ne consomme aucun crédit.

Une notification dès que le travail est terminé

Enregistrez un webhook et recevez une requête signée à la fin d'une génération, d'un rendu vidéo ou d'une correction.

Dans la langue choisie par votre agent

Contenus et commentaires sont produits dans la langue demandée par votre agent.

Serveur MCP

Conçu pour les agents, pas seulement les humains.

Votre agent découvre seul les outils de TutorFlow : s'inscrire, consulter son solde, générer un cours, suivre la génération et corriger des réponses, sans écrire de code HTTP.

  • Une entrée de serveur dans la configuration de votre client MCP suffit pour connecter Claude, Gemini ou tout autre client MCP
  • Votre agent s'inscrit lui-même et reçoit sa clé dans le même appel
  • Quand les crédits s'épuisent, il envoie un lien de paiement à une personne ou, si x402 est activé, paie lui-même en USDC
  • Des entrées typées : un appel incorrect revient avec la raison de l'erreur
Guide MCPPrise en main des agents
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_..."
      }
    }
  }
}
SDK MCP
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...',
})
Inscription autonome
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 }
Tarifs

Payez ce que votre agent crée

Chaque appel est débité d'un seul solde de crédits sur votre compte, à 2 cents le crédit. Voici la grille tarifaire à jour appliquée à votre agent.

Ce que vous créezCréditsDollars US
Un cours avec son plan et toutes ses leçons3 crédits plus 6 crédits par leçon0,06 $US plus 0,12 $US par leçon
Un module de leçon6 crédits par leçon0,12 $US par leçon
Un examen avec des questions corrigées automatiquement3 crédits par examen0,06 $US par examen
Une diapositive de texte1 crédit par page de texte0,02 $US par page de texte
Une diapositive avec une image IA3 crédits par page avec image0,06 $US par page avec image
La narration des scènes d'une vidéo1 crédit par scène0,02 $US par scène
Le rendu d'une vidéo en MP43 crédits par rendu0,06 $US par rendu
Un jeu prêt à jouer41 crédits par jeu0,82 $US par jeu
La correction d'une réponse1 crédit par requête0,02 $US par requête

Comment fonctionne la facturation

  • Rechargez à partir de 5 $ par carte ou en USDC sur Base une fois votre e-mail vérifié.
  • Avec une carte enregistrée, le travail continue une fois les crédits épuisés, et cette utilisation est facturée sur la carte.
  • Un nouveau compte démarre avec 50 crédits offerts.
  • Les clés de test fonctionnent dans une classe en ligne de test et ne consomment aucun crédit.
Lire le guide des tarifs
Votre agent peut commencer

Confiez dès aujourd'hui son premier cours à votre agent

Inscrivez-le via l'API, MCP ou la CLI. Les 50 crédits d'essai couvrent un premier cours et quelques réponses corrigées.

Inscrire votre agentLire la documentation