Aptora MCP server

Read from the package source without running it. The installed server may list more.

• create_assessmentwrite action

  Create a new assessment. Call get_authoring_guide first. Pass workspace_directory to give candidates starter files. Dry-run it (get_dry_run_guide) before inviting anyone.

• create_interviewwrite action

  Create an interview for a candidate WITHOUT emailing them. Returns the interview including its link, which you can share yourself. Also used for dry runs. Use invite_candidate to have Aptora send the invitation email.

• get_assessment

  Fetch one assessment by id, including its full configuration.

• get_authoring_guide

  How to write an Aptora assessment: field meanings, the required ProseMirror problem format, environment constraints, setup hooks and black-box services, personas, and grading categories. Call before creating or editing an assessment.

• get_dry_run_guidewrite action

  Step-by-step QA of an assessment by taking it as a test candidate in a browser: files, setup hook, black-box services, personas, browser preview. Call before dry-running an assessment.

• get_grading_results

  Fetch the full AI grading report for a completed interview: scorecard, timeline, metrics. Grading runs asynchronously after completion \u2014 the response reports in-progress status when not done yet.

• get_workspace_snapshot

  Fetch the candidate's final workspace (file tree with contents) captured when the interview ended. Can be large.

• invite_candidatewrite action

  Create an interview AND send the candidate a real invitation email immediately. Only use when the user explicitly wants the invitation sent.

• list_assessments

  List all assessments in the user's organization.

• list_interviews

  List all interviews in the user's organization with status and grading summary (overall score, reviewed flag).

• update_assessmentwrite action

  Update an existing assessment. Only the fields you pass change; everything else is preserved. Pass workspace_directory to replace the starter workspace.

• whoami

  Return the Aptora user the configured API key belongs to. Use to verify the connection.

• Code scan2 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenanceno repository listed3/15
• Maintainer identityverified namespace with website, no repo4/10

Aptora: common questions

Is Aptora MCP server safe?

With care: it is graded C, so read the findings first (58/100). Read the Aptora safety report

How do I install Aptora?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Aptora need an API key?

Yes. The registry entry asks for APTORA_API_KEY.

Is Aptora maintained?

The latest release is v1.0.0.