Evaluar MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/YOUR_USERNAME/evaluar-mcp.git
cd evaluar-mcp
npm install
npm run build
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "EVALUAR_AUTH_URL=${EVALUAR_AUTH_URL}" -e "EVALUAR_API_URL=${EVALUAR_API_URL}" -e "EVALUAR_GRAPHQL_URL=${EVALUAR_GRAPHQL_URL}" -e "EVALUAR_CLIENT_ID=${EVALUAR_CLIENT_ID}" evaluar -- node "<FULL_PATH_TO_EVALUAR_MCP>/dist/index.js"

Replace <FULL_PATH_TO_EVALUAR_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:EVALUAR_AUTH_URLEVALUAR_API_URLEVALUAR_GRAPHQL_URLEVALUAR_CLIENT_ID
README.md

Launch eTalent recruitment processes on Evaluar directly from your IDE.

Evaluar MCP Server

MCP Server para lanzar procesos eTalent en Evaluar desde tu IDE.

Requisitos

  • Node.js >= 18
  • Cuenta de Evaluar con credenciales válidas

Instalación

git clone https://github.com/YOUR_USERNAME/evaluar-mcp.git
cd evaluar-mcp
npm install
npm run build

Configuración en Claude Code

Agrega la configuración en ~/.claude.json o en el archivo de configuración MCP de tu IDE:

{
  "mcpServers": {
    "evaluar": {
      "command": "node",
      "args": ["/ruta/absoluta/a/evaluar-mcp/dist/index.js"],
      "env": {
        "EVALUAR_AUTH_URL": "https://auth.evaluar.com/auth/realms/evcore/protocol/openid-connect/token",
        "EVALUAR_API_URL": "https://apis.evaluar.com",
        "EVALUAR_GRAPHQL_URL": "https://apis.evaluar.com/v2/graphql",
        "EVALUAR_CLIENT_ID": "evcap"
      }
    }
  }
}

Tools Disponibles

Tool Descripción
auth_login Autenticación con usuario/password
auth_refresh Refrescar token de autenticación
company_list Listar empresas del usuario
company_select Seleccionar empresa activa
position_search Buscar positions por nombre
process_create Crear proceso eTalent en DRAFT
process_assign_position Asociar position al proceso
process_launch Lanzar proceso y obtener URL summary

Flujo de Uso

  1. Autenticarse: auth_login con tus credenciales
  2. Seleccionar empresa (si tienes varias): company_listcompany_select
  3. Buscar position: position_search con el nombre del perfil
  4. Crear proceso: process_create con nombre descriptivo
  5. Asignar position: process_assign_position con IDs del paso 3 y 4
  6. Lanzar: process_launch → obtener URL del summary

Ejemplo

Usuario: "Lanza un proceso eTalent para un asesor de ventas"

1. auth_login(username, password)
2. company_list() → seleccionar empresa
3. position_search("asesor ventas")
4. process_create(name: "Proceso eTalent - Asesor Ventas")
5. process_assign_position(processId, positionId, agencyId, departmentId)
6. process_launch(processId) → URL: https://app.evaluar.com/cap/process/etalent/{id}/summary

Licencia

MIT

Tools (8)

auth_loginAuthenticate with username and password.
auth_refreshRefresh the authentication token.
company_listList all companies associated with the user.
company_selectSelect an active company.
position_searchSearch for positions by name.
process_createCreate an eTalent process in DRAFT status.
process_assign_positionAssociate a position with a process.
process_launchLaunch a process and retrieve the summary URL.

Environment Variables

EVALUAR_AUTH_URLrequiredThe authentication endpoint URL for Evaluar.
EVALUAR_API_URLrequiredThe base API URL for Evaluar.
EVALUAR_GRAPHQL_URLrequiredThe GraphQL endpoint URL for Evaluar.
EVALUAR_CLIENT_IDrequiredThe client ID for Evaluar authentication.

Configuration

claude_desktop_config.json
{"mcpServers": {"evaluar": {"command": "node", "args": ["/ruta/absoluta/a/evaluar-mcp/dist/index.js"], "env": {"EVALUAR_AUTH_URL": "https://auth.evaluar.com/auth/realms/evcore/protocol/openid-connect/token", "EVALUAR_API_URL": "https://apis.evaluar.com", "EVALUAR_GRAPHQL_URL": "https://apis.evaluar.com/v2/graphql", "EVALUAR_CLIENT_ID": "evcap"}}}}

Try it

Log me into my Evaluar account.
List my available companies and select the first one.
Search for a 'Sales Advisor' position.
Create a new eTalent process named 'Q4 Hiring' and launch it.

Frequently Asked Questions

What are the key features of Evaluar?

Authenticate and manage sessions with Evaluar platform. Browse and select user-associated companies. Search for recruitment positions by name. Create and manage eTalent recruitment processes in draft mode. Launch recruitment processes and generate summary URLs.

What can I use Evaluar for?

Streamlining recruitment workflows by initiating processes directly from the IDE. Automating the creation of draft recruitment processes for specific job profiles. Quickly retrieving summary URLs for launched recruitment processes for team sharing.

How do I install Evaluar?

Install Evaluar by running: git clone https://github.com/YOUR_USERNAME/evaluar-mcp.git && cd evaluar-mcp && npm install && npm run build

What MCP clients work with Evaluar?

Evaluar works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Evaluar docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare