Referencia de Ferramentas MCP

O servidor MCP expoe 18 ferramentas, uma para cada endpoint da Career API.

Ferramentas Publicas (Sem Autenticacao)

Ferramenta	Descricao	Endpoint API
`list_templates`	Listar todos os modelos de curriculo	`GET /v1/templates`
`get_template`	Obter detalhes de um modelo	`GET /v1/templates/{id}`
`list_fonts`	Listar tipos de letra disponiveis	`GET /v1/fonts`
`list_languages`	Listar idiomas suportados	`GET /v1/languages`
`list_models`	Listar modelos de IA disponiveis	`GET /v1/models`

Ferramenta	Descricao	Endpoint API
`list_resumes`	Listar os seus curriculos	`GET /v1/resumes`
`get_resume`	Obter um curriculo especifico	`GET /v1/resumes/{id}`
`parse_resume`	Analisar PDF/DOCX para dados estruturados	`POST /v1/resumes/parse`
`render_resume`	Renderizar curriculo para PDF	`PUT /v1/resumes/{id}/render`

Ferramenta	Descricao	Endpoint API
`tailor_resume`	Personalizar curriculo para uma descricao de emprego	`POST /v1/tailor`
`export_resume`	Exportar curriculo como PDF	`POST /v1/export`

Ferramenta	Descricao	Endpoint API
`list_cover_letters`	Listar cartas de apresentacao	`GET /v1/cover-letters`
`get_cover_letter`	Obter uma carta de apresentacao	`GET /v1/cover-letters/{id}`
`create_cover_letter`	Criar manualmente	`POST /v1/cover-letters`
`generate_cover_letter`	Gerar carta de apresentacao com IA	`POST /v1/cover-letters/generate`
`render_cover_letter`	Renderizar para PDF	`PUT /v1/cover-letters/{id}/render`

Ferramenta	Descricao	Endpoint API
`get_settings`	Obter definicoes do modelo de IA	`GET /v1/settings`
`set_model`	Definir modelo de IA personalizado (BYOK)	`PUT /v1/settings/model`
`reset_model`	Repor modelo predefinido	`DELETE /v1/settings/model`

Cada ferramenta aceita parametros correspondentes ao seu 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-..."
}

Todas as ferramentas devolvem respostas JSON estruturadas. As ferramentas de PDF devolvem o caminho do ficheiro onde o PDF foi guardado.