What you need
- A Mira Resume Pro, Elite or Lifetime plan (pricing).
- An API key from Dashboard > API & MCP. It is shown once.
- Windsurf, installed and signed in.
Steps
- Open Windsurf Settings > Cascade > MCP Servers > View raw config.
- Paste the block below into mcp_config.json and save.
- Press Refresh in the MCP panel. The Mira Resume tools appear in Cascade.
Configuration
Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mira-resume": {
"serverUrl": "https://miraresume.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_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
- List my Mira Resume resumes and tell me which one is the strongest for a Data Analyst role.
- 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.
Every tool and its parameters are listed in the MCP guide.
Troubleshooting
| Problem | Fix |
|---|---|
| Server never connects | Windsurf expects serverUrl for remote servers, not url. Copy the block above as is, save, then press Refresh. |
| 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.