DoxAI
ContentsMCP connector

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.

  1. Add a custom connector and name it DoxAI.
  2. Paste the connector URL shown below.
  3. Sign in with your DoxAI account when Claude asks. Sign-in uses OAuth: there is no token to copy.
https://app.doxai.ch/v1/mcp

Job 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_profile to read the profile, then quick_apply with 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. Then get_application_cv_pdf for the CV link, generate_letter to draft or redraft the cover letter, get_application_letter for its link, and update_application_status once the user has sent the application.
Calls counted against the quota
analyze_opportunity, generate_application, generate_letter and quick_apply are counted against the plan quota and need a stable request_id. A retry with the same request_id replays 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_status returns the plan (free, plus or pro), the quota as percentages used (day and week windows on Plus and Pro, remaining action counts on Free) and ai_settings: the pinned model, the default effort and the models the plan may use.
Choosing a model
quick_apply and generate_application accept an optional model (an id from ai_settings.models) for that call only, on Plus and Pro. The Free plan gets model_not_available. Their results include a model field naming the model that drafted the CV.
Long calls
quick_apply and generate_application run for minutes. They report progress step by step when the client sends a progressToken, 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 in cutForTime (quick_apply) or cut_for_time (generate_application). After a timeout, retry with the same request_id to 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 tools

Search and rank job ads from across Switzerland.

  • search_jobsSearch Job Ads

    Search job ads from across Switzerland by keywords, canton, work rate and age.

    Read-onlyNo sign-in
  • get_jobGet Job Ad

    Read one job ad in full, by the id search_jobs or recommend_jobs returned.

    Read-onlyNo sign-in
  • recommend_jobsRecommend Job Ads for a CV or the Profile

    Rank job ads against the profile, or against a pasted CV text (not stored).

    Read-onlyNo sign-in with cv_text

Profile

3 tools

Read and edit the career profile every document is drafted from.

  • get_profileGet DoxAI Career Profile

    Read the career profile, its revision and the quota status.

    Read-only
  • update_profileUpdate DoxAI Career Profile

    Change profile fields; pass the revision you just read as base_revision.

    Writes
  • patch_profile_entriesEdit DoxAI Profile Entries by ID

    Add, update or remove profile entries by id, in one all-or-nothing batch.

    Writes

Postings and analysis

4 tools

Save job postings and score them against the profile.

  • list_opportunitiesList Job Opportunities

    List the saved job postings, newest first.

    Read-only
  • get_opportunityGet Job Opportunity

    Read one saved posting with its stored analysis.

    Read-only
  • create_opportunityCapture Job Opportunity

    Save a posting from its URL, its text or a job ad id.

    Writes
  • analyze_opportunityAnalyze Job Opportunity

    Score a posting against the profile and store the analysis.

    WritesQuota

Tailored CV and letter

8 tools

Draft, review and track one application per posting.

  • quick_applyTailor a CV for a Job Posting

    From a posting to a reviewed CV, and a letter, in one call.

    WritesQuota
  • create_applicationOpen Application

    Open an application for a saved posting.

    Writes
  • generate_applicationGenerate Tailored Application

    Draft the tailored CV and letter of an application, then review them.

    WritesQuota
  • generate_letterDraft Cover Letter

    Draft or redraft the cover letter of an application.

    WritesQuota
  • list_applicationsList Applications

    List applications with their status, most recently updated first.

    Read-only
  • get_applicationGet Application

    Read one application: status, letter, notes and review points.

    Read-only
  • resolve_review_pointsAnswer Review Points

    Record the user’s answer to each review point: keep, soften or drop.

    Writes
  • update_application_statusUpdate Application Status

    Record where an application stands, once the user has acted.

    Writes

Documents and PDF

13 tools

Compile CVs and letters to PDF, manage saved resumes.

  • get_application_cv_pdfGet Application CV PDF

    Compile the application’s CV to PDF and return a download link.

    Writes
  • get_application_letterGet Application Cover Letter

    Export the cover letter as PDF or .docx and return a download link.

    Writes
  • resume_list_templatesList Resume Templates

    List the CV templates, colours, fonts and sizes.

    Read-onlyNo sign-in
  • resume_get_create_job_exampleGet Resume Job Example

    Return a canonical cv_data example to start from.

    Read-only
  • resume_validate_cv_dataValidate Resume Data

    Check cv_data and list what to fix, without compiling.

    Read-only
  • resume_create_jobCreate Resume PDF Job

    Start a PDF compile job from cv_data.

    Writes
  • resume_get_jobGet Resume PDF Job

    Read a compile job’s status and, once it succeeded, its PDF link.

    Read-only
  • resume_get_pdfGet Resume PDF Download

    Return a short-lived download link for a finished job’s PDF.

    Read-only
  • resume_list_jobsList Resume PDF Jobs

    List the compile jobs, newest first.

    Read-only
  • cv_list_resumesList Resumes

    List the saved resumes, newest first.

    Read-only
  • cv_get_resumeGet Resume

    Read one saved resume.

    Read-only
  • cv_create_resumeCreate Resume

    Save a new resume from a canonical CV snapshot.

    Writes
  • cv_update_resumeUpdate Resume

    Replace a saved resume’s content, or change its template or status.

    Writes

Plan and quota

2 tools

Read the plan, the quota left and the server details.

  • account_get_billing_statusGet Plan and Quota

    Read the plan, the quota as percentages and ai_settings.

    Read-only
  • app_get_infoGet DoxAI Information

    Read 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-05

The 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:

CodeHTTPWhat to do
auth_required401Sign-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.
unauthorized401The bearer token is missing or invalid on a route that needs one, such as the REST API. Send a valid token.
quota_exceeded402The plan quota is used up. Tell the user.
model_not_available403The plan cannot use this model. Read ai_settings.models.
request_in_progress409The first call still runs. Wait retry_after_seconds, retry with the same request_id.
request_id_conflict409This request_id was used for another action. Use a new one.
profile_revision_conflict409The profile changed. Read get_profile again before retrying.
resume_pdf_not_ready409The PDF is still compiling. Wait retry_after_seconds, then call again.
rate_limited429Too 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.