Herramienta

Qué responde

Pregunta de ejemplo

get-profile

Devuelve el registro de perfil único de Marcos Alvarez — nombre, titular, ubicación, disponibilidad y una breve biografía — como un objeto, con citas que lo respaldan. Úsalo para responder «quién es esta persona» o «cuál es su disponibilidad/ubicación actual» de un vistazo. No lo uses para el historial laboral rol por rol (usa get-experience), para detalles específicos de proyectos (usa search-projects) ni para comprobar si se declara una habilidad o tecnología concreta (usa get-skill-evidence). No recibe entrada. No hay un resultado de «sin resultado» en el funcionamiento normal — el conjunto de datos de este servidor siempre tiene exactamente un perfil.

«¿Quién es Marcos Alvarez y está actualmente abierto a nuevos roles?»

get-experience

Devuelve cada entrada del historial laboral de Marcos Alvarez que coincida con un filtro estructurado opcional — empresa, etiquetas de tecnología, un rango de fechas YYYY-MM y estado actual/pasado — como una lista ordenada de la más reciente a la más antigua, cada entrada con una cita. Úsalo para responder «qué hizo en la empresa X», «en qué trabajó en el año Y» o «qué está haciendo ahora». Si se llama sin campos de filtro, devuelve el historial completo. No lo uses para el resumen de perfil único (usa get-profile), para buscar descripciones de proyectos por palabra clave (usa search-projects) ni para comprobar si se declara una habilidad con nombre (usa get-skill-evidence). Un filtro que no coincida con ningún rol devuelve un resultado correcto con una lista vacía, no un error.

«¿En qué ha trabajado Marcos desde 2022? Explícame sus roles recientes.»

search-projects

Busca en el portafolio de proyectos de Marcos Alvarez por palabra clave y/o etiqueta de tecnología y devuelve coincidencias clasificadas, cada una con una puntuación de relevancia, una explicación del campo coincidente y una cita. La coincidencia es una búsqueda determinista por palabra clave/etiqueta en nombres de proyectos, resúmenes, cuerpos y etiquetas de tecnología — no hay comprensión semántica ni basada en embeddings de la consulta hoy. Úsalo cuando se te pida encontrar o describir proyectos específicos, p. ej. «muéstrame proyectos que usaran React» o «qué construyó con Kubernetes». No lo uses para un historial laboral cronológico (usa get-experience) ni para comprobar si una habilidad se declara en absoluto, con evidencia o sin ella (usa get-skill-evidence). Una consulta que no coincida con ningún proyecto devuelve un resultado correcto con una lista vacía, no un error; una consulta vacía o de solo espacios en blanco se comporta igual.

«Muéstrame proyectos donde Marcos usara TypeScript o Kubernetes.»

get-skill-evidence

Consulta una única habilidad o tecnología con nombre e informa uno de tres resultados honestos: 'claimed' (la habilidad con su evidencia de respaldo), 'not-claimed' (una brecha explícita y reconocida con su propia declaración y habilidades relacionadas) o 'unknown' (el término no coincide con ninguna). Úsalo cuando se te pregunte «¿conoces X?» o «¿has trabajado con Y?» sobre una tecnología específica. No lo uses para explorar la lista completa de habilidades (no existe tal herramienta en este servidor) ni para buscar descripciones de proyectos por palabra clave (usa search-projects en su lugar), y no sustituye a get-experience cuando la pregunta es sobre un rol o empresa en lugar de una sola habilidad. Un resultado 'not-claimed' o 'unknown' es una respuesta normal y correcta, no un error — transmítelo con honestidad en lugar de reintentar o alucinar alrededor de él.

«¿Ha trabajado Marcos con arquitecturas basadas en eventos? Muéstrame la evidencia.»

search-career

Ejecuta una búsqueda difusa y semántica sobre el texto completo del contenido profesional de Marcos Alvarez (experiencia, proyectos, habilidades, escritos) y devuelve extractos clasificados, cada uno con una puntuación de relevancia y una cita, o un resultado explícito de 'no relevant content found' cuando nada supera el umbral de similitud. Úsalo para preguntas abiertas, transversales o conceptuales que una búsqueda estructurada no puede responder directamente — p. ej. «¿ha trabajado con arquitecturas basadas en eventos?», «¿cuál es su experiencia liderando equipos?», «¿algo sobre optimización de costes?». No lo uses cuando la pregunta se corresponda con una búsqueda estructurada específica que las herramientas deterministas ya responden con exactitud: get-profile para quién es, get-experience para un historial laboral por rol/empresa/rango de fechas, search-projects para búsqueda de proyectos por palabra clave/etiqueta y get-skill-evidence para comprobar una habilidad o tecnología concreta con nombre — prefiere esas primero y recurre a esta herramienta solo cuando no encajen. Esta herramienta es más cara por llamada (incrusta la consulta) y está sujeta a la misma más cara por llamada (incrusta la consulta) y está sujeta al mismo límite de velocidad de todo el servidor que cualquier otra herramienta aquí — no la llames repetidamente para la misma pregunta.

«¿Cuál es la experiencia de Marcos liderando equipos de ingeniería y haciendo mentoría?»

Variable

Propósito

SITE_URL

Anulación opcional del origen absoluto del propio sitio. No es obligatorio: Vercel lo deriva automáticamente.

UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN

Credenciales de Upstash Redis que respaldan la limitación de velocidad de /api/mcp. Si no se establecen, fallan en modo abierto (sin limitación) en lugar de dar error.

RATELIMIT_MAX_REQUESTS, RATELIMIT_WINDOW_SECONDS

Anula la ventana de limitación de velocidad del endpoint MCP.

CHAT_PROVIDER, CHAT_MODEL_ID

Selecciona y fija el proveedor/ID del modelo del agente de chat.

GOOGLE_GENERATIVE_AI_API_KEY

Obligatorio cuando CHAT_PROVIDER=google (el valor predeterminado).

ANTHROPIC_API_KEY

Obligatorio solo cuando CHAT_PROVIDER=anthropic.

CHAT_SESSION_RATELIMIT_MAX_REQUESTS, CHAT_SESSION_RATELIMIT_WINDOW_SECONDS, CHAT_IP_RATELIMIT_MAX_REQUESTS, CHAT_IP_RATELIMIT_WINDOW_SECONDS, CHAT_AGENT_MAX_STEPS

Ajuste de las salvaguardas del chat: consulte apps/web/README.md «Chat guardrails».

DATABASE_URL

Cadena de conexión de Neon Postgres para el módulo @hire-me-mcp/core/db (migraciones, ingesta, searchCareer). Consulte packages/core/README.md.

NEON_API_KEY, NEON_PROJECT_ID

Crea/elimina una rama Neon desechable solo para el conjunto de pruebas de integración de la base de datos; nunca se usa contra la base de datos principal.