StudentCenter over MCP

Lists institutions, all of them for superadmin keys and only their own for institution keys.

Gets a single institution by slug, scoped to the caller's own institution for institution keys.

Views MCP audit log entries for retracing recent writes, filterable by tool name or error status.

Updates patchable institution fields: logo, website, description, accent color, social links, support contact, and theme.

Queries verified and pending learners from institution_student_emails, auto-scoped for institution keys.

Aggregates learner stats: total, verified, active, inactive, and pending counts.

Gets skill mastery progress across learners for an institution, useful for spotting weak areas in the cohort.

Invites a single learner or admin to the institution by email.

Invites many learners at once, reporting per-email success.

Approves or rejects a pending learner enrollment request.

Updates a learner's enrollment status: active, inactive, or graduated.

Surfaces learners who appear stuck: no recent skill progress activity.

Lists minted credentials, auto-scoped to the institution key's own institution.

Gets a single minted credential by ID, scoped to the caller's own institution.

Aggregates credential stats: total minted, active templates, mint rate, and recent activity.

Lists credential templates, auto-scoped to the institution key's own institution.

Creates a new credential template for an institution.

Updates fields on an existing credential template.

Records a manual credential issuance for a learner; NFT minting still completes via the institution dashboard.

Issues a credential to a single learner, looking up their wallet and minting the NFT on chain via thirdweb.

Issues a template to many learners at once, minting in batch and reporting per-learner success.

Revokes a credential issued by this institution; cannot revoke credentials belonging to other institutions.

Lists skills in the global taxonomy, optionally filtered by domain, for building curricula or tagging games.

Lists skill curricula for an institution.

Gets a curriculum with all of its ordered steps.

Creates a new skill curriculum for an institution.

Adds one or many skill steps to a curriculum.

Removes a step from a curriculum by step ID.

Publishes or unpublishes a curriculum.

Returns per-learner progress through a curriculum, including completed steps and percent complete.

Suggests skills to add to a curriculum based on a goal description, matched against the global skills taxonomy.

Lists badge definitions for an institution: slug, level, linked credential template, and prerequisites.

Lists badges actually issued to learners, joined to badge name and learner email.

Returns per-learner progress toward every badge path in the institution, including which learners are mint-ready.

Diagnoses the badge system for an institution: dangling mappings, unreachable point thresholds, and stuck learners.

Records a learner's game attempt in the badge system and recomputes their path progress idempotently.

Records that a badge has been issued to a learner and marks their path progress as issued; refuses to double-issue.

Creates or updates a badge definition; omit badge_id to create a new one.

Lists gamified learning activities for an institution.

Creates a game stub only: a row with title, slug, and description but no scenes, questions, or content yet.

Updates a game's metadata, mechanics config, status, and scene order.

Links a skill to a game with a weight controlling how much it contributes to mastery.

Lists all scenes in a game ordered by scene order.

Creates a scene in a game: intro, content, cutscene, or other scene types.

Creates a layer in a scene, with higher layer order rendering on top.

Adds a positioned element, such as text, character, or button, to a scene layer.

Adds a trigger to an element or scene defining when something happens, such as onClick.

Adds an action to a trigger defining what happens when it fires.

Gets full detail of a game: metadata, scenes, questions, and skill tags, for auditing.

Creates a quiz question for a game.

Adds an answer option to an MCQ or true/false question, marking exactly one as correct.

Adds a draggable item to a drag-and-drop question.

Adds a drop target zone to a drag-and-drop question.

Creates a reusable character or narrator definition for a game.

Runs a read-only diagnostic on a scene-mode game and returns a structured report of issues by severity.

Runs sc_audit_game against every scene-mode game in an institution and returns a ranked rollup.

Repairs legacy MCQ wiring, rebuilding onCorrect/onIncorrect triggers. Defaults to a dry run.

Scaffolds a complete story-driven scene-mode game in one call, creating an intro scene and narrative content.

Publishes a game, setting its status to published so learners can access it.

Unpublishes a game, setting its status back to draft so learners can no longer access it.

Duplicates an existing game, including scenes, questions, and skills, into a new draft.

Duplicates a credential template into a new inactive copy.

Duplicates a curriculum and all of its steps into a new unpublished copy.

Returns per-game analytics: attempts, unique learners, completion rate, pass rate, and average score.

Full-text searches the marketplace for published templates, filterable by category and difficulty.

Fetches full details on a single marketplace template by slug.

Imports a previously purchased marketplace template into this institution.

Full-text searches the marketplace for published learning-path listings, filterable by category.

Fetches full details on a single marketplace learning-path listing by slug.

Imports a previously confirmed learning-path purchase into this institution; does not perform the purchase itself.

Creates a draft marketplace listing from a curriculum, kicking off an async asset-freeze job.

Lists badge-system learning paths for an institution with points required and linked badges.

Gets one learning path with its mapped games resolved to titles and required flags.

Creates or updates a badge-system learning path; omit path_id to create a new one.

Replaces the full game mapping for a learning path in one call, validating every game exists first.

Removes a single game from a learning path without rewriting the whole mapping.

Creates a community post in the institution's feed.

Toggles the pinned state on a community post.

Lists subgroups for the institution.

Creates a new subgroup for the institution with an auto-generated slug.

Sends a templated email to a single learner, a list of learners, or every active verified learner in the institution.

Returns a full analytics dashboard for an institution: learner, credential, game, and curriculum stats.

Exports institution data as CSV text for learners, credentials, templates, games, or the audit log.

Returns time-bucketed counts of credentials minted, learners joined, and game attempts.

Runs a battery of health checks across an institution; call this first when connecting to a new one.

Returns the top highest-leverage next actions for an institution.

Returns which environment the MCP server is targeting, staging or production.

Returns platform KPIs: members, credentials minted, mint rate, and active templates.

Lists companies from the employers table.

Returns inbox stats for the StudentCenter operational email account.

Returns items needing attention in the next 7 days: pending verifications and stalled onboarding.

Returns the last 10 notable platform events: new learners, minted credentials, and new institutions.

Checks an institution's onboarding status: wallet, contract, admin, and verification flags.

Resolves a user by email address, returning id, email, name, and created date.

Sets or clears the is_verified flag on an institution.

Changes an institution's subscription tier.

Adds a new skill to the global taxonomy.

Revokes a minted credential, flipping the StatusList bit and cascading to any composite credential built from it.

Provisions a new tenant API key for an institution, returning the raw key once.

Creates a new institution row, auto-generating a slug from the name if not provided.

Provisions a thirdweb Engine server wallet for an institution.

Deploys an ERC-721 soulbound credential contract for an institution on chain.

Transfers the admin role of an institution's credential contract to an external wallet. Irreversible.

Sets or clears the is_featured flag on an institution.

Links a user as admin or owner of an institution.

Generates an AI image with Gemini and sets it as a game's thumbnail.

Generates an AI badge or credential image with Gemini and sets it on the credential template.

Animates a credential template's image into a short looping video with Google Veo 2.

Refunds a confirmed Stripe learning-path purchase with explicit control over the Connect transfer and platform fee.