Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gupy-candidate-mcp find remote front-end jobs and analyze my fit"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
O gupy candidate é um servidor MCP que ajuda pessoas candidatas a se candidatarem a vagas hospedadas no Gupy. Ele entrega dados + análise + templates de preparação para a sua IA (opencode, Claude, Gemini CLI etc.) — o raciocínio e a redação ficam na IA cliente. Nenhuma chave de LLM é embutida.
Empregabilidade orientada por IA, não "corrida atrás de vaga". Este projeto não se candidata no seu nome nem decide por você — ele te entrega dados reais das vagas e um ponto de partida, para que você entenda onde se encaixa e chegue melhor preparado. É uma ferramenta de capacitação, com transparência sobre como a IA pode (e não pode) ajudar na sua jornada de candidatura.
Tool | Descrição |
| Busca vagas públicas no Gupy (termo, estado, modalidade, tipo, empresa). |
| Lê os detalhes de uma vaga pelo ID. |
| Carrega e valida o perfil do candidato a partir de um arquivo JSON. |
| Cruza perfil x requisitos da vaga e gera score e pontos fortes/atenção. |
| Gera o template de prompt para |
| Verifica prazos de candidatura (urgente/proximo/ok). |
Related MCP server: job-agent-mcp
npm install
npm run buildPerfil do candidato: crie um JSON no formato de src/schema/profile.schema.json e passe o caminho para carregar_perfil / analisar_aderencia / preparar.
Para registrar no opencode, adicione ao seu opencode.json:
"gupy-candidate": {
"type": "local",
"command": ["node", "C:\\caminho\\ate\\gupy-candidate-mcp\\dist\\index.js"],
"enabled": true
}npm test # rodar testes
npm run build # compilar
npm run dev # watch mode (tsx)Analisa a aderência do perfil a uma vaga.
Inputs: vagaId (required), caminhoPerfil.
Busca vagas públicas no Gupy com filtros opcionais.
Inputs: term, limit, state, offset, +3 more.
Carrega e valida o perfil do candidato a partir de um arquivo JSON.
Inputs: caminho (required).
Detalha uma vaga pelo ID.
Inputs: id (required).
Monitora os prazos de inscrição de uma lista de vagas.
Inputs: vagas (required).
Gera a entrega (currículo, carta ou formulário) para uma vaga com base no perfil.
Inputs: vagaId (required), entrega (required), caminhoPerfil.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool targets a distinct stage of the candidate workflow: searching jobs, viewing details, loading a profile, analyzing fit, preparing application materials, and monitoring deadlines. There is no overlapping or ambiguous functionality.
Most tools follow a verb_noun pattern (buscar_vagas, carregar_perfil, analisar_aderencia, preparar, monitorar), but 'detalhe_vaga' uses a noun phrase instead of a verb, creating a minor inconsistency.
Six tools cover the core application lifecycle without being excessive or too sparse. Each tool serves a clear purpose within the candidate-oriented workflow.
The toolset covers searching, profiling, fit analysis, preparation, and monitoring, but lacks a tool for actually submitting the application, which is a notable gap. However, the existing tools still support a coherent end-to-end assistance flow.
Public MCP server for discovering open jobs. Search, filter, and get application links.
GetJobzi MCP server for job search, application tracking, and career forecasting.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for VC pitch-deck scoring, thesis-fit matching, and deal-flow management.
