What you need
- A Mira Resume Pro, Elite or Lifetime plan (pricing).
- An API key from Dashboard > API & MCP. It is shown once.
- OpenAI Codex, installed and signed in.
Steps
- Add the block below to ~/.codex/config.toml.
- Set the key in your shell profile: export MIRA_API_KEY=mira_sk_... (PowerShell: $env:MIRA_API_KEY = "mira_sk_...").
- Start codex and run /mcp to see the Mira Resume tools.
Configuration
Where it goes: ~/.codex/config.toml
[mcp_servers.mira-resume]
url = "https://miraresume.com/api/mcp"
bearer_token_env_var = "MIRA_API_KEY"Replace YOUR_API_KEY with your key where the config shows it. Server URL: https://miraresume.com/api/mcp
Keep your key private
Do not commit config files that contain your key. If a key leaks, revoke it in Dashboard > API & MCP and create a new one.Check it works
Ask: "Use Mira Resume to show my account." The assistant should call get_account and reply with your plan, credits left and today's API usage. Most clients ask you to approve a tool call the first time.
Then try a read: "List my resumes on Mira Resume." If you get a 401 or 403 instead, see troubleshooting.
Example prompts
- Check my latest resume against this job posting and tell me the missing skills: <paste the job>
- Show my new Mira Scout matches above 70 and add the best three to my Job Tracker as wishlist.
- Rewrite the summary of my resume for a Product Manager role and save it after I approve.
Every tool and its parameters are listed in the MCP guide.
Troubleshooting
| Problem | Fix |
|---|---|
| 401 although the key is correct | Codex reads the key from MIRA_API_KEY in the shell that starts it. Open a new terminal after editing your profile, or export it in the current one. |
| 401 unauthorized | The key is missing, mistyped or revoked. Keys start with mira_sk_. Create a new one in Dashboard > API & MCP if needed. |
| 403 plan_required | API access needs Pro, Elite or Lifetime. A key stops working while the account is on Free and starts again after an upgrade. |
| 429 rate_limited or daily_limit | Per-minute or daily limit reached (Pro 300 a day, Elite 3,000). Wait for Retry-After or 00:00 UTC. |
Other clients
Back to the MCP server guide, the REST API reference or the resume MCP server overview.