Reference
MCP connector
Connect DoxAI to Claude, ChatGPT or any remote MCP client, then let it call the tools below.
Connect DoxAI to Claude
The DoxAI connector is a remote MCP server. Its URL is shown below; the same URL works for ChatGPT and any other remote MCP client.
- Add a custom connector and name it DoxAI.
- Paste the connector URL shown below.
- Sign in with your DoxAI account when Claude asks. Sign-in uses OAuth: there is no token to copy.
https://app.doxai.ch/v1/mcpJob search (search_jobs, get_job, recommend_jobs with cv_text) and the two reference tools app_get_info and resume_list_templates work before you sign in. The other tools ask you to sign in the first time they are used.
ChatGPT and other remote MCP clients use the same URL. A client without OAuth support can use a personal API token with the mcp:connect scope.
The connector works on the Free plan, with the same limits as the DoxAI web app. Plus and Pro raise the quota.
Without OAuth
Create a personal API token with the mcp:connect scope on your account page and send it as a Bearer token:
{
"url": "https://app.doxai.ch/v1/mcp",
"headers": { "Authorization": "Bearer <token with mcp:connect>" }
}How the tools work
- Typical flow
get_profileto read the profile, thenquick_applywith a posting URL or text: it captures, scores and drafts the application in one call. To review the fit first, go step by step:create_opportunity→analyze_opportunity→create_application→generate_application. Thenget_application_cv_pdffor the CV link,generate_letterto draft or redraft the cover letter,get_application_letterfor its link, andupdate_application_statusonce the user has sent the application.- Calls counted against the quota
analyze_opportunity,generate_application,generate_letterandquick_applyare counted against the plan quota and need a stablerequest_id. A retry with the samerequest_idreplays the stored result and is never counted a second time. Reads, profile edits, job search and PDF compilation are free.- Plan and quota
account_get_billing_statusreturns the plan (free, plus or pro), the quota as percentages used (day and week windows on Plus and Pro, remaining action counts on Free) andai_settings: the pinned model, the default effort and the models the plan may use.- Choosing a model
quick_applyandgenerate_applicationaccept an optionalmodel(an id fromai_settings.models) for that call only, on Plus and Pro. The Free plan getsmodel_not_available. Their results include amodelfield naming the model that drafted the CV.- Long calls
quick_applyandgenerate_applicationrun for minutes. They report progress step by step when the client sends aprogressToken, and they are kept under the client’s tool-call time limit: optional steps (company research, review, revision, layout corrections) may be cut short and are then listed incutForTime(quick_apply) orcut_for_time(generate_application). After a timeout, retry with the samerequest_idto get the stored result.- Drafts only
- DoxAI drafts application material and never sends or submits it: the user reviews it and applies themselves. Generated content only uses facts from the user’s profile.
Tools
33 tools, grouped by purpose. Call tools/list for the full input and output schemas.
Job ads
3 toolsSearch and rank job ads from across Switzerland.
search_jobsSearch Job AdsSearch job ads from across Switzerland by keywords, canton, work rate and age.
Read-onlyNo sign-inget_jobGet Job AdRead one job ad in full, by the id search_jobs or recommend_jobs returned.
Read-onlyNo sign-inrecommend_jobsRecommend Job Ads for a CV or the ProfileRank job ads against the profile, or against a pasted CV text (not stored).
Read-onlyNo sign-in with cv_text
Profile
3 toolsRead and edit the career profile every document is drafted from.
get_profileGet DoxAI Career ProfileRead the career profile, its revision and the quota status.
Read-onlyupdate_profileUpdate DoxAI Career ProfileChange profile fields; pass the revision you just read as base_revision.
Writespatch_profile_entriesEdit DoxAI Profile Entries by IDAdd, update or remove profile entries by id, in one all-or-nothing batch.
Writes
Postings and analysis
4 toolsSave job postings and score them against the profile.
list_opportunitiesList Job OpportunitiesList the saved job postings, newest first.
Read-onlyget_opportunityGet Job OpportunityRead one saved posting with its stored analysis.
Read-onlycreate_opportunityCapture Job OpportunitySave a posting from its URL, its text or a job ad id.
Writesanalyze_opportunityAnalyze Job OpportunityScore a posting against the profile and store the analysis.
WritesQuota
Tailored CV and letter
8 toolsDraft, review and track one application per posting.
quick_applyTailor a CV for a Job PostingFrom a posting to a reviewed CV, and a letter, in one call.
WritesQuotacreate_applicationOpen ApplicationOpen an application for a saved posting.
Writesgenerate_applicationGenerate Tailored ApplicationDraft the tailored CV and letter of an application, then review them.
WritesQuotagenerate_letterDraft Cover LetterDraft or redraft the cover letter of an application.
WritesQuotalist_applicationsList ApplicationsList applications with their status, most recently updated first.
Read-onlyget_applicationGet ApplicationRead one application: status, letter, notes and review points.
Read-onlyresolve_review_pointsAnswer Review PointsRecord the user’s answer to each review point: keep, soften or drop.
Writesupdate_application_statusUpdate Application StatusRecord where an application stands, once the user has acted.
Writes
Documents and PDF
13 toolsCompile CVs and letters to PDF, manage saved resumes.
get_application_cv_pdfGet Application CV PDFCompile the application’s CV to PDF and return a download link.
Writesget_application_letterGet Application Cover LetterExport the cover letter as PDF or .docx and return a download link.
Writesresume_list_templatesList Resume TemplatesList the CV templates, colours, fonts and sizes.
Read-onlyNo sign-inresume_get_create_job_exampleGet Resume Job ExampleReturn a canonical cv_data example to start from.
Read-onlyresume_validate_cv_dataValidate Resume DataCheck cv_data and list what to fix, without compiling.
Read-onlyresume_create_jobCreate Resume PDF JobStart a PDF compile job from cv_data.
Writesresume_get_jobGet Resume PDF JobRead a compile job’s status and, once it succeeded, its PDF link.
Read-onlyresume_get_pdfGet Resume PDF DownloadReturn a short-lived download link for a finished job’s PDF.
Read-onlyresume_list_jobsList Resume PDF JobsList the compile jobs, newest first.
Read-onlycv_list_resumesList ResumesList the saved resumes, newest first.
Read-onlycv_get_resumeGet ResumeRead one saved resume.
Read-onlycv_create_resumeCreate ResumeSave a new resume from a canonical CV snapshot.
Writescv_update_resumeUpdate ResumeReplace a saved resume’s content, or change its template or status.
Writes
Plan and quota
2 toolsRead the plan, the quota left and the server details.
account_get_billing_statusGet Plan and QuotaRead the plan, the quota as percentages and ai_settings.
Read-onlyapp_get_infoGet DoxAI InformationRead public server metadata: version, endpoints and templates.
Read-onlyNo sign-in
Resources
Resource reads are scoped to the signed-in user. resources/list returns the saved resume URIs.
cv://templatesThe CV template catalogue. Readable without an account.cv://resumesIndex of the user’s saved resumes.cv://resumes/{id}One saved resume, as JSON.cv://profileThe user’s career profile and quota status.
Protocol versions
2025-11-252025-06-182025-03-262024-11-05The server negotiates the newest version both sides support during initialize. Structured tool output needs 2025-11-25 or 2025-06-18.
Errors
Tool errors carry a code. The ones an agent should handle:
| Code | HTTP | What to do |
|---|---|---|
auth_required | 401 | Sign-in needed (JSON-RPC error -32001, data.reason). Without an account only the public tools work. The WWW-Authenticate header starts OAuth; retry on the same session. |
unauthorized | 401 | The bearer token is missing or invalid on a route that needs one, such as the REST API. Send a valid token. |
quota_exceeded | 402 | The plan quota is used up. Tell the user. |
model_not_available | 403 | The plan cannot use this model. Read ai_settings.models. |
request_in_progress | 409 | The first call still runs. Wait retry_after_seconds, retry with the same request_id. |
request_id_conflict | 409 | This request_id was used for another action. Use a new one. |
profile_revision_conflict | 409 | The profile changed. Read get_profile again before retrying. |
resume_pdf_not_ready | 409 | The PDF is still compiling. Wait retry_after_seconds, then call again. |
rate_limited | 429 | Too many requests in a minute: per token, per user, per guest session, or too many document compiles. Wait retry_after_seconds if given, then retry. Without an account the limit is lower; signing in raises it. |