maestra Start for free
On this page
  1. What it is
  2. Who it is for
  3. Connect it
  4. Signing in
  5. The tools
  6. What it can and cannot do
  7. Privacy and safety
  8. Limits
  9. Example prompts
  10. Troubleshooting
  11. Questions

Docs · For teachers and course authors

The Maestra MCP connector

Build a Spanish course in the AI assistant you already use. Your assistant writes the lessons; Maestra gives it the rules, checks every piece, and keeps the result private to you and your classes.

Planned · not open yet

This connector is not open yet. This page describes how it is designed to work so you know what to expect. Until it opens there is nothing to connect to, and details such as tool names and limits may still change. We will update this page when it is ready.

What it is

MCP (Model Context Protocol) is a standard way for an AI assistant, such as Claude, to use outside tools. Maestra's connector is a remote MCP server at https://mcp.maestra.sh/mcp. You add that address to your assistant once and sign in with your Maestra account. From then on you can ask your assistant, in plain words, to build and check a course.

The assistant does the writing, including the English translation that every Spanish phrase needs. Maestra runs no AI model of its own on your courses, and building a course does not use up tokens. What Maestra adds is the rulebook (how a lesson, a reading or a grammar page must be built), an automatic check against the same content rules the app's own lessons pass, and a private place to keep the result.

A course you build is a private draft in your account. You can preview it and use it with your own classes. Nothing reaches the shared catalog without an administrator at Maestra.

Who it is for

  • Teachers who want a course or a few lessons shaped for their own classes.
  • Course authors working with Maestra (staff and contractors), who are given the author role by Maestra.

You need a Maestra account, and course authoring turned on for it. Learners do not use the connector, and it does not work from a learner-only account. Maestra for learners is for ages 13 and up; the connector does not change that. The role is checked on every request, so if your access is switched off the connector stops working at once.

How and when teachers can turn authoring on, and what it costs, are not settled yet. This page will say when they are.

Connect it

The address is the same everywhere: https://mcp.maestra.sh/mcp. Use it only when this page says the connector is open.

Claude (claude.ai and the Claude apps)

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it Maestra and paste the address above.
  3. Choose Connect. Your browser opens Maestra's sign-in and consent page.
  4. Check the page, then choose Allow.

Claude Code

claude mcp add --transport http maestra https://mcp.maestra.sh/mcp

Then run /mcp inside Claude Code and sign in. This is Claude Code's standard command for a remote server; it has not been tried against Maestra yet because the connector is not open.

ChatGPT

  1. Go to chatgpt.com/plugins and choose Add custom MCP server.
  2. Paste the address and sign in with your Maestra account.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace's policy. Some teachers will not be able to. Claude's custom connectors are the reference path.

Other clients

Any client that supports remote MCP servers over HTTP with OAuth sign-in should work in principle. At first, sign-in will be accepted only from Claude, ChatGPT, and apps running on your own computer. Other clients may be added later.

Signing in

You sign in with your Maestra account through your browser; you never paste a password or a key into your assistant. Maestra's sign-in page shows you:

  • the name of the app asking, and the address it will return to, written out so you can see where you are going;
  • what the connection can do: read and change the courses you author, and nothing else;
  • a notice that what you write passes through your AI provider.

The access you grant works only with this connector. It is not a copy of your Maestra login and cannot be used to close your account, buy anything, or reach any other part of Maestra. Access is short-lived and renews itself while you keep using it. You will be able to see your connected AI apps in your account and remove any of them, which ends that connection.

The tools

Your assistant sees the tools below and chooses between them from your request, so you rarely name one yourself. Reading tools change nothing. Writing tools change only your own courses. A tool that fails always says in one sentence how to fix it, for example exchange 3, reply 2: translation is missing — add the English.

get_authoring_guide read
The rulebook, in sections: how a course, lesson, reading and grammar page are built; Mexican Spanish conventions; how dialogue is written; what the English fields are for; level inventories; safety rules; and the exact data format of each piece. The assistant reads this first.
list_shared_content read
Searches the lessons, readings and grammar pages that ship with Maestra, by kind, level or a search word. Use them to reference, never to copy.
list_my_courses read
Your courses: name, level, status, version, how many items each has, the result of the last check, and whether you or Maestra owns it.
get_course read
One of your courses with its units, its items and the last check report.
get_item read
One lesson, reading or grammar page, either yours or one that ships with Maestra.
create_course writes
Starts a new private course: a name, a level, a description and its units. Sending the same request again returns the first result instead of making a second course.
update_course writes
Changes a course's name, description, level, units or readings. It is checked against the version it was based on, so two edits cannot silently overwrite each other.
put_item writes
Adds or replaces one lesson, reading or grammar page in a course. The reply lists that item's errors and warnings straight away.
remove_item removes
Takes an item out of a course. It is deleted only if none of your other courses uses it.
validate_course read
Runs the full check on a course and returns every error and warning, each pointing to the exact field.
preview_course read
Gives a link that opens the course in the Maestra web app for you, and a text outline: units, lessons, how many exchanges each has, and the first few.
delete_course removes
Deletes one of your courses. You must give the course's name to confirm. It is refused while the course is in use by a class that has members, and for courses Maestra owns.
request_review writes
Asks a Maestra administrator to look at a course. It needs a course with no errors and your confirmation that you have the right to use the material. It does not change who owns the course.
suggest_change writes
For a course that Maestra has taken over: sends a note to the administrators suggesting a change.

Twelve of these are planned for the first release. request_review and suggest_change follow once Maestra's own review tools exist.

What it can and cannot do

It can

  • Create, edit and delete your own private courses, and the lessons, readings and grammar pages inside them.
  • Reference any lesson, reading or grammar page that ships with Maestra, by id, in your course.
  • Check a course against Maestra's content rules and tell you exactly what to fix.
  • Let you preview the course in the web app, and enroll yourself to try it.
  • Attach your courses to classes you lead, once Maestra's classes feature is available.

It cannot

  • Publish to everyone. There is no publish tool. Only a Maestra administrator can move a course into the shared catalog.
  • Show any learner data. No rosters, no names, no progress, no practice scores, nothing a learner typed or said, and no audio. The tools return your own content and nothing else.
  • Read, change or even see another author's drafts.
  • Edit or delete a course after Maestra has taken it over, even one you created. You can send a suggestion instead.
  • Do anything outside course authoring: it cannot change your account, your plan, or your payment details.
  • Make voice clips. Maestra renders those for courses it owns, on an administrator's request; until then a lesson speaks with the device's own voice.

The content rules the check applies include accents and the opening marks ¿ ¡, an English translation on every phrase, Mexican Spanish (no vosotros), and no web links, email addresses or phone numbers in anything a learner can see. Courses should suit learners 13 and up.

Privacy and safety

What you write and what the tools return passes through your AI provider. That provider (for example Anthropic or OpenAI) is not controlled by Maestra, and its own terms and privacy policy apply to it. Maestra tells you this when you connect.

  • It acts as you. Every request is made as the signed-in author. The connection has no access to anyone else's courses and no more power than your own author role, which Maestra rechecks on every request.
  • No learner data in this connector. Please do not put students' names or other personal details into a course either: the check refuses contact details, and the author terms make you responsible for the rest.
  • Who can see a private course: you, the members of a class you attach it to, and Maestra's administrators, who may read it for safety and review. Nobody else.
  • What Maestra stores: your courses and their lessons, the confirmation that you have the right to use the material, and a record of each connection (the app's name, when it was made, when it was last used).
  • Maestra runs no AI model on your courses. Your own assistant writes. The one place a model sees authored text is the answer judge, which scores a learner's spoken answer using a lesson's situation and brief; those two fields are length-limited for that reason.
  • If Maestra takes a course over, it becomes a Maestra course for all learners, shown without your name. That only happens with a course Maestra's own staff authored, and only an administrator can do it. Teachers' courses are not taken over.
  • You are in control of the access. Remove a connected app in your account and its access ends. Turn off course authoring and the connector stops answering.

The full policy is in the privacy policy and the terms. The connector sections there are marked as planned and will be updated to match this design before launch.

Limits

These are the planned starting limits. They protect the service from a model in a loop and may change before launch. Past a limit a tool answers with the number and when it resets.

WhatLimit
Courses per author25
Items (lessons, readings, grammar pages) per author300
Size of one item1 MB
Everything you have stored25 MB
Writes60 a minute, 2,000 a day
validate_course20 a minute
All requests from one connection120 a minute
One result returned to your assistantunder 100,000 characters

Example prompts

Say what you want in your own words. Good prompts name the level, the situation and who the course is for.

  • “Read Maestra's authoring guide, then plan a four-lesson A1 course for my 9th graders about ordering food at a market. Show me the outline before you write anything.”
  • “Write the first lesson of that course and add it to Maestra. Then check it and fix anything that fails.”
  • “What lessons does Maestra already have for past-tense verbs at A2? I want to reference them, not repeat them.”
  • “Show me my courses and which of them have errors or warnings.”
  • “In lesson 3, the second reply has no English. Fix it and run the check again.”
  • “Give me a preview link for my market course.”

Troubleshooting

My assistant says it cannot connect
The connector may not be open yet; check the status at the top of this page. If it is open, check the address is exactly https://mcp.maestra.sh/mcp, then remove the connector and add it again.
I was asked to sign in again, or got “unauthorized”
Your connection ended: it was removed in your account, it expired, or it went unused for a long time. Reconnect and choose Allow again.
The sign-in page says to turn on course authoring
Your account does not have authoring turned on, or it is not available to you yet. Turn it on in your account when that option is offered.
A tool says a course “belongs to Maestra now”
Maestra has taken the course over and you can no longer edit it. Ask your assistant to send a suggestion with suggest_change.
A write was refused with an error about a field
The check found a problem. The message names the field and the fix. Ask your assistant to apply it and run validate_course.
A tool answered that I have reached a limit
See the limits above. The message says the limit and when it resets. Wait, or delete something you no longer need.
ChatGPT has no “Add custom MCP server”
It depends on your plan and your workspace's settings. Ask your workspace admin, or use Claude.
The result was cut off or too long
The guide is served in sections for this reason. Ask for one topic at a time, for example just the lesson format.

Still stuck? Write to us and tell us what you asked and what you saw. Please do not include student information.

Questions

Is this a public API?

No. It is a connector for teachers and authors, signed in with a Maestra account. It is not for general developers, and it is not listed in the Claude or ChatGPT directories for now: you add it by its address.

Can it tell me which students are behind?

No. The connector returns only the content of your own courses. It has no rosters, names, progress or scores.

Does Maestra read my conversation with my assistant?

No. Maestra sees only the requests your assistant sends to the tools (for example, a lesson it wants to save) and what it sends back. It does not see the rest of your chat.

Does it cost tokens?

No. Maestra runs no model for authoring, so nothing is charged to your tokens. Your AI assistant's own usage is between you and its provider.

Can my students use the course?

Yes, once classes are available: you attach your course to a class you lead and members can use it. Until then you can preview it and enroll yourself.

Can I make a course available to everyone?

Not through the connector. Only a Maestra administrator can add a course to the shared catalog.

Can I delete my courses?

Yes, your own, with delete_course, unless a class that has members is using the course.

Which languages does it support?

Maestra teaches Mexican Spanish to English speakers, and the guide follows that. The connector's text is in English.

Updated 6 October 2026 · MDO Labs LLC