Ripostiq

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Courses that argue back: learn adaptively, build real work, then defend it to an AI stakeholder.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Ripostiq": {
      "url": "https://ripostiq.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (24)

• login

  Claude Code plugin login only (auth_token flow). On the web/desktop connector, identity comes from the connector's OAuth approval — do NOT ask the user to type their email/password into the chat; direct them to the connector's 'Log in with Ripostiq' or ripostiq.com instead.

  Parameters:

  • email (required) — string
  • password (required) — string

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• whoami read-only

  Return the current logged-in user (via OAuth bearer or an auth_token).

  Parameters:

  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_entitlements read-only

  List the logged-in account's entitlements across courses (OAuth bearer or auth_token).

  Parameters:

  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_lesson read-only

  Fetch a module's lesson content. Free module is open; paid modules require an active entitlement. Returns {locked, teaser, checkout_url} when not entitled.

  Parameters:

  • course (required) — string
  • module (required) — string
  • section
  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• list_courses read-only

  List every available Ripostiq course (no login needed). Call this FIRST when a user wants to browse or start learning. Each course has a free Module 1 anyone can start immediately via begin_course(course) → teach_section. Returns the `course` id to pass to other tools. For a logged-in learner this also includes courses THEY authored (marked `mine`, with their `visibility`) — offer those alongside the catalog.

  Parameters:

  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• begin_course

  Start a course. Returns the tutor protocol, intake guidance, and the module map. Call this first, run the intake, then call teach_section to teach Module 1.

  Parameters:

  • course (required) — string
  • auth_token

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• roast

  Free 'Roast my work' — a single tough-but-fair stakeholder grilling of ANY artifact the user pastes (PRD, architecture, code, pitch, resume, plan, essay…). No login or course needed. `work` is the artifact (or a solid description); `kind` optionally hints the type (prd/architecture/code/pitch/strategy/resume/design…) to pick the right persona; `focus` is what they most want pushback on. Returns the roast protocol + a course recommendation. Great as an entry point when someone wants honest, pointed feedback on real work.

  Parameters:

  • work (required) — string
  • kind
  • focus
  • auth_token

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• interview_prep

  Free 'Mock interview' — a realistic, calibrated interview for a role. `jd_or_skill` is the job description (paste it) or the skill/role to interview against; `role` and `experience` (e.g. 'senior backend engineer', '5 years') calibrate difficulty; `focus` narrows it (e.g. 'system design'). No login or course needed. Returns the interview protocol + a course recommendation. Great when someone is prepping for an interview and wants a real grilling.

  Parameters:

  • jd_or_skill (required) — string
  • role
  • focus
  • auth_token
  • experience

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• list_interviews read-only

  List the curated Interview-Prep topics (e.g. 'Agentic AI in Production'). Each is a realistic, adaptive mock interview on a fixed topic — concept→scenario question pairs across several areas — that ends in a candid scorecard. No login or course needed. Call this when someone wants to prep for an interview on a topic the catalog covers, then start_interview.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• start_interview

  Begin a curated Interview-Prep session on a fixed topic. `interview` is the topic id from list_interviews (e.g. 'agentic-ai-in-production'); `role`/`experience` calibrate difficulty. LOGIN REQUIRED (free in the current beta, like a course): if the learner isn't logged in this returns needs_login — ask them to log in with the connector, don't run the questions. Once unlocked, returns the question bank + an adaptive protocol (one question at a time across ~4-5 areas, concept then scenario, hint when stuck, scorecard at the end). Save it with save_interview.

  Parameters:

  • interview (required) — string
  • role
  • auth_token
  • experience

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• teach_section

  Get one lesson section's content + the teaching protocol for it. Free module is open; paid modules require an active entitlement (returns {locked, teaser} if not). Teach it socratically, then call again with section_index+1 to advance.

  Parameters:

  • course (required) — string
  • module (required) — string
  • auth_token
  • section_index — integer

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• run_boss

  Get the module's boss-battle simulation + how to run it (in-character, real stakes, earned PASS). Gated like lessons. `difficulty` dials the intensity — 'friendly' (supportive coach), 'standard' (default), or 'brutal' (relentless, skeptical, high bar) — and optional `persona_style` sets a flavor (e.g. 'skeptical CTO', 'hostile board member'). The rubric is unchanged; only how hard the stakeholder presses. Offer the learner the choice first.

  Parameters:

  • course (required) — string
  • module (required) — string
  • auth_token
  • difficulty
  • persona_style

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• daily_drill

  The two-minute drill — today's spaced-recall question + the learner's day streak. Call it to fetch today's question (deterministic per day, drawn from modules they've started); after they answer and you reveal it, call again with done=true to log it and bump the streak. A daily habit: one question, two minutes, keep the streak alive.

  Parameters:

  • course (required) — string
  • done — boolean
  • auth_token

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• start_exam

  Start the course's SCORED PRACTICE EXAM — a full, blueprint-aligned multiple-choice mock that returns a scaled score against the real pass line, a per-domain breakdown, and rationale for every question. Login + entitlement gated like the paid capstone (returns needs_login / locked if not). Returns a drawn `form` of questions WITHOUT the answers (the key is held server-side); proctor them one at a time, collect the learner's letters, then call submit_exam(course, answers) to score. Never reveal or answer the questions yourself.

  Parameters:

  • course (required) — string
  • auth_token

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• submit_exam

  Score a practice exam started with start_exam. `answers` maps each question id to the learner's chosen letter, e.g. {"q001": "A", "q002": "C"}; unanswered questions score as incorrect. Returns the scaled score, PASS/FAIL vs the pass line, a per-domain breakdown, and the per-question rationale for review. Deliver it as an honest scorecard and point them to the weak domains' modules.

  Parameters:

  • course (required) — string
  • answers (required) — object
  • auth_token

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• get_outline read-only

  Full course outline — every module + its section titles — so the learner can pick ANY module/section to start, in any order. Marks locked modules and their progress.

  Parameters:

  • course (required) — string
  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• mark_progress

  Record the learner's progress server-side (shows on their account + syncs across devices). Call when a section is genuinely completed (section_id), or after a boss battle (boss='passed'/'failed', boss_attempt=true), or on a lab status change (lab=...).

  Parameters:

  • course (required) — string
  • module (required) — string
  • lab
  • boss
  • auth_token
  • section_id
  • boss_attempt — boolean

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• get_recap read-only

  Resume briefing for a returning learner — what they've covered, mastery levels, strong/weak topics, and recall questions to reactivate memory. Call at session start.

  Parameters:

  • course (required) — string
  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_progress read-only

  Return the learner's progress for a course — the raw doc plus a display-ready summary (per-module sections done/total, boss status, overall percent, current position), and wind_down coverage (which modules have their cheatsheet + session summary saved).

  Parameters:

  • course (required) — string
  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• recall_questions read-only

  Return spaced-recall questions drawn from the account's completed modules.

  Parameters:

  • auth_token (required) — string
  • course (required) — string
  • count — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• list_artifacts read-only

  List the learner's saved Library artifacts (titles + metadata, newest first). Use at session start (with get_recap) to reference prior work and continue seamlessly.

  Parameters:

  • course (required) — string
  • type
  • module
  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_artifact read-only

  Fetch a saved Library artifact's full content (by id, or by key+course). Use to pull a prior deliverable forward and build on it in a new chat.

  Parameters:

  • key
  • course
  • auth_token
  • artifact_id

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• submit_artifact

  Submit a lab deliverable. Stores it in the learner's Library (type='deliverable') and returns the module rubric so it can be reviewed against the bar. Call get_review next. For general note-taking use save_artifact instead.

  Parameters:

  • course (required) — string
  • module (required) — string
  • type (required) — string
  • repo_ref
  • auth_token
  • content_text

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• get_certificate read-only

  Ripostiq certificate status. Pass `module` for that module's certificate (earned when its boss battle is passed); omit it for the course certificate (earned when EVERY module's boss is passed). Both are viewable at /certificate and publicly verifiable at /verify/<code>.

  Parameters:

  • course (required) — string
  • module
  • auth_token

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.