Riferimento Strumenti MCP

Il server MCP espone 18 strumenti, uno per ogni endpoint della Career API.

Strumenti Pubblici (Senza Autenticazione)

Strumento	Descrizione	Endpoint API
`list_templates`	Elenca tutti i template per CV	`GET /v1/templates`
`get_template`	Dettagli di un template	`GET /v1/templates/{id}`
`list_fonts`	Elenca i font disponibili	`GET /v1/fonts`
`list_languages`	Elenca le lingue supportate	`GET /v1/languages`
`list_models`	Elenca i modelli AI disponibili	`GET /v1/models`

Strumento	Descrizione	Endpoint API
`list_resumes`	Elenca i tuoi CV	`GET /v1/resumes`
`get_resume`	Ottieni un CV specifico	`GET /v1/resumes/{id}`
`parse_resume`	Analizza PDF/DOCX in dati strutturati	`POST /v1/resumes/parse`
`render_resume`	Renderizza un CV in PDF	`PUT /v1/resumes/{id}/render`

Strumento	Descrizione	Endpoint API
`tailor_resume`	Ottimizza un CV per una descrizione del lavoro	`POST /v1/tailor`
`export_resume`	Esporta un CV come PDF	`POST /v1/export`

Strumento	Descrizione	Endpoint API
`list_cover_letters`	Elenca le lettere di presentazione	`GET /v1/cover-letters`
`get_cover_letter`	Ottieni una lettera di presentazione	`GET /v1/cover-letters/{id}`
`create_cover_letter`	Crea manualmente	`POST /v1/cover-letters`
`generate_cover_letter`	Genera con AI una lettera di presentazione	`POST /v1/cover-letters/generate`
`render_cover_letter`	Renderizza in PDF	`PUT /v1/cover-letters/{id}/render`

Strumento	Descrizione	Endpoint API
`get_settings`	Ottieni le impostazioni del modello AI	`GET /v1/settings`
`set_model`	Imposta un modello AI personalizzato (BYOK)	`PUT /v1/settings/model`
`reset_model`	Ripristina il modello predefinito	`DELETE /v1/settings/model`

Ogni strumento accetta parametri corrispondenti al suo endpoint API.

{
  "resumeId": "res_abc123",
  "positionName": "Senior Frontend Engineer",
  "jobDescription": "We are looking for a Senior Engineer..."
}

{
  "resumeId": "res_abc123",
  "templateId": "graphite"
}

{
  "provider": "anthropic",
  "model": "claude-haiku-4.5",
  "apiKey": "sk-ant-..."
}

Tutti gli strumenti restituiscono risposte JSON strutturate. Gli strumenti PDF restituiscono il percorso del file dove il PDF e stato salvato.