Learning Optimizer Tutorial

How to Build Your Learning Optimizer Agent

Building your Learning Optimizer Agent isn't about creating a memory algorithm from scratch. It's about connecting a compatible AI platform to specialized tools that help schedule reviews, predict retention, and organize study plans.

There are four decisions to make. Choose your agent builder, prepare the relevant learning data, decide how the data will be supplied, and connect the Learning Optimizer MCP.

Four decisions

Step 1: Find an Agent Builder

Start with an AI platform or agent-building environment that supports the MCP connection method you plan to use. Examples of platforms and environments to consider include:

The available connection methods differ by platform. Check the client's current MCP support and configuration requirements before proceeding.

The goal is to give your agent access to the Learning Optimizer's specialized tools, so it can request review schedules and retention analysis instead of relying only on general-purpose language-model responses.

Step 2: Prepare Your Learning Data

The Learning Optimizer works with information about learners, learning items, and review events. The data you need depends on the operation you want to perform.

Review History

Review-event records can include the learner identifier, learning-item identifier, review result, and time of review. These records help the scheduling engine understand how a learner has interacted with a particular item.

For example, a language-learning app may record when a learner reviews a vocabulary item and whether the response was correct.

Item Bank

An item bank is the collection of learning items the platform wants to schedule. Depending on your product, these items may represent flashcards, vocabulary, questions, concepts, or other units of learning.

For exam planning, the relevant item bank helps the agent organize a schedule around the learner's target date.

Learner and Exam Information

For study-plan optimization, provide the relevant learner information and exam date. The quality and completeness of these inputs affect how useful the resulting schedule can be.

API or Application Integration

The Learning Optimizer specification describes review events coming from the customer's application through an API and item-bank metadata supplied by upload or API.

This means a learning platform can prepare the necessary data in its own environment and connect the workflow to the scheduling tools. A native integration with a particular LMS, student information system, or learning platform should not be assumed unless it is separately available.

Step 3: Choose How Your Agent Will Access the Tools

There are two key parts to the setup: supplying the learning data and connecting the analysis tools.

Your application or data pipeline provides the review events, item identifiers, and other required inputs. The MCP exposes the Learning Optimizer tools to a compatible client.

What MCP Means Here

MCP stands for Model Context Protocol. It provides a standardized way for compatible AI applications to discover and call external tools.

Once connected, the agent can request operations such as scheduling a review, retrieving today's due items, estimating future retention, or creating an exam-oriented study plan.

An MCP connection does not automatically import your learning platform's data. Your application must still supply the required inputs through a supported integration or data workflow.

Connect

Step 4: Connect Our MCP

Connecting the Learning Optimizer MCP makes the specialized memory-scheduling tools available to a compatible AI client.

After connecting, verify that the MCP is enabled and that the client can access its available tools. The exact configuration steps depend on the client you choose.

The tools available in the initial specification include:

  • Schedule Review: Determine the next recommended review time and estimated recall probability for a learner and item.
  • Due Reviews: Retrieve a learner's review queue for a specified date.
  • Predict Retention: Estimate recall probability for a learner-item pair at a future date.
  • Optimize Study Plan: Create a review schedule around an exam date and item bank.
  • Forgetting Curve: Retrieve the modeled memory-decay curve and its parameters.
  • Explain Schedule: Explain why a review interval was selected, including the model and confidence information available.

These tools can be used to build learning workflows around the information your platform supplies. The output depends on the chosen model, available history, and the operation being requested.

Pick your platform below. Connecting our MCP is the same idea on each one — you add it once, then sign in with your Saifs AI account.

Steps to Enable MCP on AI Platforms

Open Claude and reveal the main menu

Launch Claude Desktop. In the top-left corner, click the three-dot menu to open the app's main menu.

Go to Settings

From the three-dot menu, hover over File. Click Settings (or press Ctrl + Comma).

Open the Developer config editor

In Settings, select the Developer tab. Click Edit Config at the bottom of the panel. A File Explorer window will open at the Claude config folder. Click to select claude_desktop_config.json.

Paste the Learning Optimizer MCP

With the config file open, add this server — not the generic Saifs AI MCP. This one is Learning Optimizer only. Then restart Claude.

Launch Cursor

Open the Cursor application on your desktop. On the home screen, choose Open project, Clone repo, or Connect via SSH to begin working on a project.

Settings → Tools & Integrations

Click the gear icon (top right) or go to File → Settings. In the left panel, click Tools & Integrations. Scroll to MCP Tools and click Add Custom MCP.

Add the Learning Optimizer MCP

After clicking Add Custom MCP, Cursor opens the MCP config file. Add this server — not the generic Saifs AI MCP. This one is Learning Optimizer only. Click Connect next to the new MCP server under MCP Tools to start the integration.

Complete authentication

When prompted, select Open so Cursor can process the URI and start the login flow. Sign in with your Saifs AI account, then click Open to finish the connection and confirm the toggle is ON.

Open ChatGPT Settings

From the ChatGPT home page, go to Settings.

Open Connectors

Click Connectors in the settings menu. Click Create in the browse connectors section.

Add the Learning Optimizer MCP

Enter this server — not the generic Saifs AI MCP. This one is Learning Optimizer only. Then click Save.

Save and start asking

Click Save. You can now ask the agent to schedule a review, list today's due items, or build a study plan around an exam date in ChatGPT.

Install an MCP-compatible client

Open the VS Code marketplace and install an MCP-compatible client.

Open the command palette

Open the command palette, type MCP: add, and select MCP: Add Server to start the wizard. Search MCP: Add Server and choose HTTP (HTTP or Server-Sent Events) to connect to a remote MCP server.

Enter the Learning Optimizer MCP URL

Input this server URL — not the generic Saifs AI MCP. This one is Learning Optimizer only. Press Enter to confirm. When prompted, choose Global (all workspaces) or Workspace (this workspace only).

Allow authentication

Allow the server to authenticate so VS Code can talk to the Learning Optimizer MCP. The MCP server should show as Running. That confirms the Learning Optimizer Agent is connected in VS Code.

Walkthrough

What Our AI Agent Can Actually Do — A Walkthrough

Once connected, the Learning Optimizer Agent can use its available tools to help your learning product decide what to review, when to review it, and how to organize preparation for a target date.

Imagine you operate a test-preparation app. Learners complete practice questions every day, but your platform still needs a systematic way to decide which questions should return for revision and when.

Here's how the Learning Optimizer can support that workflow.

  1. Schedule the Next Review for a Learning Item

    A learner reviews a question or flashcard. Your application supplies the learner identifier, item identifier, and latest review result.

    The schedule_review tool can use this information to return a recommended next review time and an estimated probability that the learner will recall the item.

    This helps your application move beyond a fixed schedule that treats every learner and every item the same way.

    Example prompt: “Based on this learner's latest result for the selected flashcard, schedule its next review and explain the recommendation.”

  2. Generate Today's Review Queue

    Learners often need help deciding what to study next. The due_reviews tool can retrieve the items due for a learner on a specified date and return a priority-ordered review queue.

    Your application can use this information to present a focused daily revision list rather than asking learners to choose from the entire content library.

    Example prompt: “Show this learner's reviews due today, in priority order, and summarize what they should work on first.”

  3. Estimate Future Recall

    Sometimes a learning platform needs to understand how likely a learner is to remember an item at a future point—for example, before an upcoming practice test.

    The predict_retention tool estimates the probability of recall for a selected learner-item pair at a specified future date. This can help the platform identify items that may deserve additional revision.

    The result is a model-based estimate, not a guarantee of the learner's future performance.

    Example prompt: “Estimate this learner's recall probability for the selected item on the date of their next practice test.”

  4. Build a Study Plan Around an Exam Date

    A learner preparing for a competitive exam may have hundreds of questions or concepts to revisit before the test. A generic schedule may not account for the review history of individual items.

    The optimize_study_plan tool can use learner information, an exam date, and an item bank to create a structured review schedule designed to support retention by the target date.

    This gives test-preparation platforms a foundation for exam-oriented revision planning rather than relying entirely on manual scheduling.

    Example prompt: “Create a review plan for this learner using the available item bank and upcoming exam date. Organize the schedule to support retention by exam day.”

  5. Understand How Memory Changes Over Time

    A learning item that was easy to recall yesterday may become harder to remember after a longer gap. The forgetting_curve tool can return a fitted decay curve and associated model parameters for a learner-item pair.

    This provides a way to inspect how the selected model represents memory change over time. It can also help developers and learning teams understand the information that informs scheduling decisions.

    Example prompt: “Show the modeled forgetting curve for this learner and item, and explain what it suggests about the review schedule.”

  6. Explain Why a Review Was Scheduled

    Personalized scheduling is easier to trust when the reason behind a recommendation can be explained.

    The explain_schedule tool is designed to explain why a particular interval was chosen, including the model and confidence information available. This can help a learning product provide more context about review recommendations instead of showing a date without explanation.

    Example prompt: “Explain why the next review for this item is scheduled at this interval, and describe the model's confidence and limitations.”

  7. Adapt Scheduling as Review History Accumulates

    A learning product may start with limited historical data. A baseline method such as SM-2 can provide a practical starting point, while more data-driven approaches such as Half-Life Regression and FSRS can use relevant review history for more personalized modeling.

    The initial model choice, available data, and quality of implementation determine what can be personalized. More review events do not automatically guarantee better predictions; performance should be evaluated against actual learner outcomes.

    Example prompt: “Review the available learning history and explain which scheduling approach is appropriate for this stage of the product, given the data available.”

That's the Shift

From fixed revision intervals and manual study planning to a more structured, data-informed review workflow.

The Learning Optimizer MCP gives compatible applications access to specialized tools for review scheduling, daily review queues, retention estimates, forgetting-curve modeling, and exam-oriented study planning.

The result is a foundation for more personalized learning experiences—without requiring every EdTech team to build its own spaced-repetition engine from scratch.

Discover Our MCP on Leading AI Platforms

Lead Scorer

Lead Scorer

Score and prioritize inbound leads.

View In App
Lead Scorer

Lead Scorer

Score and prioritize inbound leads.

View In App
Lead Scorer

Lead Scorer

Score and prioritize inbound leads.

View In App
Lead Scorer

Lead Scorer

Score and prioritize inbound leads.

View In App
AI Text
  • Coming Soon
Download the app
playstore-button applestore-button windows-button
Company
Join Us