Coming soon

Mira Resume MCP server guide

Connect your Mira Resume account to an AI assistant that speaks the Model Context Protocol. Your assistant can then read and update your resumes, score them against a job, manage your Job Tracker and list your Mira Scout matches. Prefer plain HTTP? See the REST API reference.

API v1, November 2026
On this page

Before you start

  • A Pro, Elite or Lifetime plan. Free accounts cannot create API keys (see pricing).
  • An API key. Create one in Dashboard > API & MCP. It is shown once, so copy it straight into your client or a password manager.
  • An MCP client, such as Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex or Gemini CLI.

Server address

MCP server URL
https://miraresume.com/api/mcp
TransportStreamable HTTP, stateless. Responses are JSON (no SSE stream; GET returns 405).
Server namemira-resume
Protocol versions2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
Capabilities11 tools and 2 prompts. Resources: none in v1 (resources/list returns an empty list).

Authentication

Every request carries your API key. Keys start with mira_sk_ and act as you: anything the key does, it does on your account.

Header (recommended)
Authorization: Bearer mira_sk_...

If your client cannot set an Authorization header, send x-api-key: mira_sk_... instead.

  • A key is shown once when you create it. We store only a hash, so we cannot show it again; create a new one if you lose it.
  • Revoke a key any time in Dashboard > API & MCP. It stops working on the next request.
  • Pro accounts can hold 2 active keys, Elite 10. Use one key per client so you can revoke one without touching the others.

No OAuth sign-in yet

Mira Resume uses API keys only for now. Connectors that require an OAuth sign-in, such as ChatGPT connectors and claude.ai web connectors, cannot connect directly yet. ChatGPT works through a custom GPT with Actions on the REST API.

Connect your client

Pick your client. Replace YOUR_API_KEY with your key, or follow the client's prompt where it asks for it.

  1. Create an API key in Mira Resume (Dashboard > API & MCP).
  2. Run the command below in your terminal. Add --scope user to use it in every project.
  3. Start Claude Code and type /mcp: "mira-resume" should show as connected.
  4. Ask: "List my resumes on Mira Resume."
Terminal (one command)
claude mcp add --transport http mira-resume https://miraresume.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Full Claude Code guide, with checks and troubleshooting

Tools

All tools are available on Pro, Elite and Lifetime unless marked otherwise. Only one tool uses AI credits; everything else counts only toward your request limits.

ToolGroupPlanCreditsAccess
get_accountAccountPro and EliteNo creditsRead-only
list_resumesResumesPro and EliteNo creditsRead-only
get_resumeResumesPro and EliteNo creditsRead-only
create_resumeResumesPro and EliteNo creditsWrite
update_resumeResumesPro and EliteNo creditsWrite (replaces data)
check_resume_against_jobResumesPro and EliteNo creditsRead-only
list_applicationsJob trackerPro and EliteNo creditsRead-only
add_applicationJob trackerPro and EliteNo creditsWrite
update_applicationJob trackerPro and EliteNo creditsWrite
list_job_matchesMira ScoutPro and EliteNo creditsRead-only
analyze_job_descriptionAIElite30 creditsRead-only

get_accountGet account

Pro and EliteNo creditsRead-onlyAccount

Your plan, AI credits left this month, and today's API usage and limits.

Parameters

No parameters.

REST equivalent: GET /me

list_resumesList resumes

Pro and EliteNo creditsRead-onlyResumes

Lists your resumes with id, name, target role, last update and saved ATS score.

Parameters

ParameterTypeRequiredDescription
limitintegerOptionalMax resumes to return (default 50).

REST equivalent: GET /resumes

get_resumeRead a resume

Pro and EliteNo creditsRead-onlyResumes

Returns one resume in full, as structured JSON or as Markdown.

Parameters

ParameterTypeRequiredDescription
resume_idstring (uuid)RequiredThe resume id (a UUID).
format"json" | "markdown"Optional"json" (default) returns structured sections; "markdown" returns readable text.

REST equivalent: GET /resumes/{resume_id}

create_resumeCreate a resume

Pro and EliteNo creditsWriteResumes

Creates a new resume, optionally with content. It appears in My Resumes and opens in the editor.

Parameters

ParameterTypeRequiredDescription
namestringRequiredName shown in My Resumes, e.g. "Data Analyst - Acme".
target_rolestringOptionalThe role this resume targets.
resumeobjectOptionalInitial content. Omit to start empty.

REST equivalent: POST /resumes

update_resumeUpdate a resume

Pro and EliteNo creditsWrite (replaces data)Resumes

Replaces the sections you send (for example summary, skills or experience). Sections you leave out stay as they are.

Parameters

ParameterTypeRequiredDescription
resume_idstring (uuid)RequiredThe resume id (a UUID).
namestringOptional-
target_rolestringOptional-
resumeobjectRequiredSections to replace. Sections you leave out are not changed.

REST equivalent: PATCH /resumes/{resume_id}

check_resume_against_jobCheck resume against a job

Pro and EliteNo creditsRead-onlyResumes

Scores a resume against a job posting (0-100) with matched and missing skills. The same deterministic scorer as Mira Scout; no AI, no credits.

Parameters

ParameterTypeRequiredDescription
resume_idstring (uuid)RequiredThe resume id (a UUID).
job_descriptionstringRequiredThe full job posting text.
job_titlestringOptionalThe job title, if it is not the first line of the posting.

REST equivalent: POST /resumes/{resume_id}/match

list_applicationsList applications

Pro and EliteNo creditsRead-onlyJob tracker

Lists the applications in your Job Tracker, optionally by status.

Parameters

ParameterTypeRequiredDescription
status"wishlist" | "applied" | "interviewing" | "offered" | "rejected"Optional-
limitintegerOptionalMax rows (default 50).

REST equivalent: GET /applications

add_applicationAdd an application

Pro and EliteNo creditsWriteJob tracker

Adds a job to your Job Tracker (default status: wishlist).

Parameters

ParameterTypeRequiredDescription
companystringRequired-
rolestringRequired-
job_urlstringOptional-
status"wishlist" | "applied" | "interviewing" | "offered" | "rejected"OptionalDefault "wishlist".
applied_datestringOptionalYYYY-MM-DD.
salarystringOptional-
notesstringOptional-
resume_idstring (uuid)OptionalThe resume version used for this application.

REST equivalent: POST /applications

update_applicationUpdate an application

Pro and EliteNo creditsWriteJob tracker

Changes an application's status, notes or next step.

Parameters

ParameterTypeRequiredDescription
application_idstring (uuid)RequiredThe application id (a UUID).
status"wishlist" | "applied" | "interviewing" | "offered" | "rejected"Optional-
notesstringOptional-
next_actionstringOptional-
next_action_datestringOptionalYYYY-MM-DD.

REST equivalent: PATCH /applications/{application_id}

list_job_matchesList Mira Scout matches

Pro and EliteNo creditsRead-onlyMira Scout

Jobs Mira Scout found for you, best first, with score, reasons and the link to apply.

Parameters

ParameterTypeRequiredDescription
status"new" | "saved" | "applied" | "dismissed"OptionalDefault "new".
min_scoreintegerOptional-
limitintegerOptionalMax matches (default 25).

REST equivalent: GET /scout/matches

analyze_job_descriptionAnalyze a job description (AI)

Elite30 creditsRead-onlyAI

AI extraction of a posting's required and preferred skills, must-have keywords, seniority and responsibilities. Elite only; uses 30 credits, refunded if the AI fails.

Parameters

ParameterTypeRequiredDescription
job_descriptionstringRequiredThe full job posting text.
target_rolestringOptional-

REST equivalent: POST /ai/analyze-job

Prompts

Prompts are ready-made starting points. Clients that support MCP prompts show them in a menu or as slash commands.

tailor_resumeTailor a resume to a job

Reads your resume, checks it against a job posting and proposes edits before saving them.

ArgumentRequiredDescription
resume_idYesThe resume to tailor (from list_resumes).
job_descriptionYesThe full job posting text.

review_resumeReview a resume

A recruiter-style review of one resume: impact, keywords, length and ATS safety.

ArgumentRequiredDescription
resume_idYesThe resume to review (from list_resumes).

Limits

Limits are per account, across all your keys, and REST and MCP requests count together. The daily count resets at 00:00 UTC. If your plan changes to Free, your keys stop working until you upgrade again.

FeatureFreeProElite
API and MCP accessNoYesYes
Active API keys-210
Requests per day-3003,000
Requests per minute-3090
Resume, tracker and Mira Scout tools-YesYes
Resume vs job match check-Free, unlimited within limitsFree, unlimited within limits
AI tools that use credits-NoYes

Errors

The MCP server and the REST API share these error codes. Over REST you get the HTTP status below with an error object; over MCP your assistant receives the same code and message.

CodeStatusMeaning
unauthorized401Missing, malformed, unknown or revoked API key.
plan_required403Your plan does not include the API, or this tool needs Elite.
scout_unavailable403Mira Scout is not available on your account yet.
not_found404No resume or application with that id on your account.
invalid_input400The body or a parameter failed validation; the message says which.
rate_limited429Too many requests this minute. Retry after the Retry-After header.
daily_limit429Today's request allowance is used up. Resets at 00:00 UTC.
insufficient_credits402Not enough AI credits for this tool.
ai_failed502The AI model did not return a usable answer. You were not charged.
internal500Something went wrong on our side.

Security

  • Keys are stored as a SHA-256 hash with a short display prefix. They are never logged and never echoed back in errors.
  • Every request is scoped to the account that owns the key. A key cannot read another user's data.
  • The MCP server and the API use the key only: they do not read or set cookies.
  • Inputs are validated against the same schemas shown on this page. Request bodies are capped at 1 MB and a resume at 200 KB of JSON.
  • Writes go through the same checks as the resume editor, so a resume saved by your assistant opens normally in Mira Resume.
  • Whatever your assistant reads (for example a resume) is processed by that assistant's provider under its own terms. Treat a key like a password and keep config files with keys out of shared repositories.

Troubleshooting

ProblemFix
401 unauthorizedThe key is missing, mistyped or revoked. Copy it again (it starts with mira_sk_), check there is exactly one space after "Bearer", or create a new key in Dashboard > API & MCP.
403 plan_requiredAPI access is part of Pro, Elite and Lifetime. If your plan lapsed to Free, the key stops working and starts again when you upgrade. The AI tool needs Elite.
429 rate_limited or daily_limitYou hit the per-minute limit (wait for Retry-After seconds) or today's allowance (300 on Pro, 3,000 on Elite; resets at 00:00 UTC). Limits are shared across all your keys.
Claude Desktop shows the server as failedClaude Desktop starts the mcp-remote bridge with npx, which needs Node.js 18 or newer. Install it, then quit and reopen Claude Desktop.
Windows: header with a space breaksSome Windows launchers split arguments on spaces, so "Bearer <key>" arrives in two pieces. Use the env-variable form shown in the Claude Desktop config (Authorization:Bearer ${MIRA_API_KEY} with the key in env).
Tools do not show upSave the config, then fully restart the client (quit, not just close the window). Check the JSON is valid: no trailing commas, and merge into an existing mcpServers block instead of adding a second one.
GET returns 405Expected. The server answers POST requests with JSON and does not open an SSE stream. Use a client that supports Streamable HTTP.
402 insufficient_creditsThe AI tool needs credits. Credits refill monthly; nothing else in the API uses them.

Read this page with AI

Open this page in your assistant with a ready prompt: it explains the setup in plain language and walks you through it.