Skip to content

AcademIA MCP

AcademIA MCP connects an agent to AcademIA’s MCP server, designed for teachers who build courses. The agent can search your courses, read a path, a module or a lesson, and write or fix lessons, or put together a whole course from a guide. Everything it writes stays as a draft: nothing is published to learners until the teacher reviews it.

You don’t have to choose an operation: the component gives the agent every tool the server offers, and the agent decides which one to use each time.

When to use it

  • A teacher wants an assistant in a chat that knows their courses and helps them improve the lessons.
  • You want an agent to draft a whole course from a document or a guide.
  • An agent must review a path’s lessons and suggest corrections.

Configuration

You need an MCP Remote server credential with the address of AcademIA’s MCP server and a way to access it. See Credentials and Use MCP servers.

  • MCP Server url: the AcademIA API address or its MCP server address, for example https://academia.nappai.es/api/mcp.
  • MCP Server auth: api_key, with the teacher’s personal key in MCP api key. You can also use OAuth2.1 and sign in with your AcademIA account.

The teacher creates the personal key in AcademIA, under Settings › Integrations, with Create key:

  1. Give it a Name to recognise it, for example NappAI.
  2. Under Permissions, Read my courses is required. Also tick Create and edit my courses if you want the agent to be able to write (always as drafts).
  3. Choose the Expiry and confirm with your password.
  4. Copy the key, which starts with nappai_prof_sk_live_. AcademIA only shows it once.
FieldWhat it does
Credential (required)The MCP Remote server credential with the AcademIA address and the teacher’s key.
MCP server URLFilled in by the credential: the AcademIA address or its MCP server address (the one ending in /mcp).
Only these tools (advanced)Optional. The names of the tools you want to give the agent, separated by commas. Empty: every tool the server offers.

Tools the agent receives

The list comes from AcademIA’s server itself when the flow runs. These are the ones it offers:

ToolWhat it does
academia_whoamiSays which teacher the key belongs to, what permissions it has and when it expires.
academia_search_contentSearches by text in the titles and content of the teacher’s courses.
academia_get_pathReads a path’s details and its tree of modules and lessons.
academia_get_moduleReads a module with its objectives, its quiz and the list of its lessons.
academia_get_lessonReads a whole lesson, with its content.
academia_apply_course_manifestCreates or updates a whole course (details, modules, lessons and quizzes) in a single operation.
academia_upsert_lessonCreates a lesson or rewrites it entirely.
academia_patch_lessonFixes part of a lesson.
academia_request_reviewSends the course to the academy’s review. There is no tool to publish.

The last four are only available if the key has the Create and edit my courses permission.

Output

The Tools output delivers the tools ready for an agent. Connect it to the Tools input of an Agent.

Example

A teacher wants an assistant to help her polish her Excel course.

  1. Build a chat with Chat Input, an Agent and Chat Output.
  2. Add AcademIA MCP with the credential holding her personal key and connect Tools to the agent’s Tools input.
  3. In the agent’s instructions, explain that it works on the teacher’s AcademIA courses, that everything it writes stays as a draft, and that it must show her the changes before asking for review.
  4. The teacher writes “Review the pivot tables lesson and simplify the examples” and the agent reads the lesson, fixes it and tells her what changed.

Good practices

  • For an assistant that only reads, create the key with Read my courses only, or put only the reading tools in Only these tools, for example academia_search_content, academia_get_path, academia_get_lesson.
  • For a fixed step of the flow, without an agent, use the other AcademIA components, such as AcademIA Content.
  • If a name in Only these tools doesn’t exist on the server, the component fails and tells you which tools it has.

Security and limitations

  • It is a server for building courses: it gives no access to organisations, enrollments, analytics or users. The other AcademIA components are there for that.
  • The agent acts as the teacher who owns the key and only sees their courses.
  • Everything the agent writes stays as a draft. It can’t publish or delete anything.
  • The key gives access to all of the teacher’s courses until it expires. If it is no longer used, revoke it in AcademIA, under Settings › Integrations.