Servidores

Servidor	URL	Autenticación
Público	https://jenksguo.xyz/mcp	ninguna
Administrador	https://jenksguo.xyz/mcp/admin	Authorization: Bearer <admin token>
Local (stdio)	jenks mcp / jenks mcp --admin	env JENKSGUO_ADMIN_TOKEN para admin

Transporte: HTTP transmitible, sin estado, JSON-RPC 2.0 sobre POST (protocolo 2025-06-18). GET en cualquiera de las URL devuelve un documento de descubrimiento. Nombre del servidor jenksguo, versión 1.1.0.

curl -s https://jenksguo.xyz/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brief","arguments":{}}}'

Herramientas públicas

get_brief — Obtener el brief de Jenks

Un brief de una página en Markdown sobre Jenks Guo: posicionamiento, rol actual, trayectoria profesional, fortalezas, idiomas, contacto y cómo explorar más. Empieza aquí.

• MCP: get_brief en https://jenksguo.xyz/mcp
• REST: GET /api/v1/brief
• CLI: jenks brief

Sin argumentos.

curl -s "https://jenksguo.xyz/api/v1/brief"

list_experience — Listar experiencia

Lista las experiencias, proyectos, roles comunitarios y formación de Jenks (lo más reciente primero), opcionalmente filtrado por etiqueta de industria, lente de rol o tipo. Devuelve formas cortas: título, organización, periodo, resumen, resultado clave, URL de la página.

• MCP: list_experience en https://jenksguo.xyz/mcp
• REST: GET /api/v1/entries?tag=&lens=&kind=&locale=
• CLI: jenks list [--tag it] [--lens solution-architect] [--kind project]

Argumento	Tipo	Obligatorio	Notas
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	no
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	no
kind	experience · education · community · project	no
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (predeterminado en).

curl -s "https://jenksguo.xyz/api/v1/entries"

get_entry — Obtener una entrada

Texto largo completo de una experiencia, proyecto, rol comunitario o formación por slug: panorama general, qué hizo Jenks, logros, por qué importa para empleadores, resultados clave, habilidades, enlaces de prueba.

• MCP: get_entry en https://jenksguo.xyz/mcp
• REST: GET /api/v1/entries/{slug}?locale=
• CLI: jenks get <slug>

Argumento	Tipo	Obligatorio	Notas
slug	cadena	sí	Slug de la entrada, p. ej. xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (predeterminado en).

curl -s "https://jenksguo.xyz/api/v1/entries/xero-developer-evangelist"

list_lenses — Listar lentes de rol

Las lentes de rol a través de las cuales los empleadores pueden ver a Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) con un pitch, brechas honestas y recuentos de evidencias.

• MCP: list_lenses en https://jenksguo.xyz/mcp
• REST: GET /api/v1/lenses?locale=
• CLI: jenks lenses

Argumento	Tipo	Obligatorio	Notas
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (predeterminado en).

curl -s "https://jenksguo.xyz/api/v1/lenses"

search_jenks — Buscar en el corpus

Búsqueda por palabras clave en cada entrada y documento. Devuelve los pasajes con mejor coincidencia con sus slugs.

• MCP: search_jenks en https://jenksguo.xyz/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

Argumento	Tipo	Obligatorio	Notas
query	cadena	sí

curl -s "https://jenksguo.xyz/api/v1/search"

get_document — Obtener un documento

Uno de los documentos de referencia de Jenks: profile (perfil principal), credentials (formación, certificaciones), capabilities (mapa de capacidad → evidencias), talks (charlas, pódcasts, escritura), thinking (visión del mundo).

• MCP: get_document en https://jenksguo.xyz/mcp
• REST: GET /api/v1/documents/{name}?locale=
• CLI: jenks doc <name>

Argumento	Tipo	Obligatorio	Notas
name	profile · credentials · capabilities · talks · thinking	sí
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (predeterminado en).

curl -s "https://jenksguo.xyz/api/v1/documents/credentials"

ask_jenks — Preguntar al asistente de Jenks

Hazle al asistente Ask Jenks una pregunta en lenguaje natural (encaje con un rol, definición de consultoría, consejo sobre transformación de IA, historias STAR, gobernanza…). Ejecuta sus propias herramientas sobre el corpus y responde en el idioma solicitado. Con límite de velocidad.

• MCP: ask_jenks en https://jenksguo.xyz/mcp
• REST: POST /api/v1/ask
• CLI: jenks ask "<question>"

Argumento	Tipo	Obligatorio	Notas
question	cadena	sí
locale	en · zh · zh-hant · ja · fr · es · eo	no	Idioma para campos traducidos (predeterminado en).
history	arreglo	no	Turnos anteriores opcionales.

curl -s -X POST https://jenksguo.xyz/api/v1/ask \
  -H 'content-type: application/json' \
  -d '{"question":"Is Jenks a fit for a Head of AI role?"}'

Herramientas de administración

admin_schema — Esquema de contenido

El modelo de contenido: campos y reglas de entradas, etiquetas, lentes, tipos, rutas editables, documentos y convenciones de edición. Léelo antes de escribir.

• MCP: admin_schema en https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/schema (token de admin)
• CLI: jenks admin schema

Sin argumentos.

curl -s "https://jenksguo.xyz/api/admin/schema" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_list_files — Listar archivos de contenido

Lista archivos de contenido editables en una rama (ruta, tamaño, sha), opcionalmente dentro de una carpeta como content/corpus/experiences.

• MCP: admin_list_files en https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/files?dir=&branch= (token de admin)
• CLI: jenks admin ls [dir]

Argumento	Tipo	Obligatorio	Notas
dir	cadena	no	p. ej. content/corpus/projects (predeterminado: todo el contenido)
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).

curl -s "https://jenksguo.xyz/api/admin/files" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_read_file — Leer un archivo de contenido

Lee la fuente Markdown/JSON sin procesar de un archivo de contenido (con su sha). Pasa path, o slug para una entrada, lente o habilidad.

• MCP: admin_read_file en https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/file?path=&slug=&branch= (token de admin)
• CLI: jenks admin get <slug|path>

Argumento	Tipo	Obligatorio	Notas
path	cadena	no
slug	cadena	no
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).

curl -s "https://jenksguo.xyz/api/admin/file" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_validate — Validar un cambio

Valida el contenido del archivo contra el esquema de contenido sin confirmar. Devuelve una lista de problemas (vacía = válido).

• MCP: admin_validate en https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/validate (token de admin)
• CLI: jenks admin validate <path> <file>

Argumento	Tipo	Obligatorio	Notas
path	cadena	sí
content	cadena	sí

curl -s -X POST https://jenksguo.xyz/api/admin/validate \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","content":"<content>"}'

admin_write_file — Crear o actualizar un archivo de contenido

Valida y confirma un archivo de contenido (crear o reemplazar). La publicación es automática: CI retraduce las entradas cambiadas a todos los idiomas, recompila y despliega (main → jenksguo.xyz, dev → dev.jenksguo.xyz) en unos minutos.

• MCP: admin_write_file en https://jenksguo.xyz/mcp/admin
• REST: PUT /api/admin/file (token de admin)
• CLI: jenks admin put <path> <file> -m <message>

Argumento	Tipo	Obligatorio	Notas
path	cadena	sí
content	cadena	sí
message	cadena	sí	Mensaje de commit
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).

curl -s -X PUT https://jenksguo.xyz/api/admin/file \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","content":"<content>","message":"<message>"}'

admin_delete_file — Eliminar un archivo de contenido

Elimina un archivo de contenido (p. ej., quitar una entrada) con un mensaje de commit. El historial de Git lo mantiene recuperable.

• MCP: admin_delete_file en https://jenksguo.xyz/mcp/admin
• REST: DELETE /api/admin/file?path=&message=&branch= (token de admin)
• CLI: jenks admin rm <path> -m <message>

Argumento	Tipo	Obligatorio	Notas
path	cadena	sí
message	cadena	sí
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).

curl -s -X DELETE https://jenksguo.xyz/api/admin/file \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"path":"content/corpus/projects/example.md","message":"<message>"}'

admin_commit_changes — Confirmar varios archivos a la vez

Valida y confirma varios cambios de archivos como UN solo commit. Cada cambio es {path, content} o {path, delete: true}.

• MCP: admin_commit_changes en https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/changes (token de admin)
• CLI: jenks admin commit <changes.json> -m <message>

Argumento	Tipo	Obligatorio	Notas
changes	arreglo	sí
message	cadena	sí
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).

curl -s -X POST https://jenksguo.xyz/api/admin/changes \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"changes":"<changes>","message":"<message>"}'

admin_ai_edit — Redactar una edición con IA

Pide al modelo del sitio que reescriba un archivo de contenido a partir de una instrucción en inglés simple. Devuelve el contenido propuesto, un diff y problemas de validación. NO confirma — revisa y luego llama a admin_write_file.

• MCP: admin_ai_edit en https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/ai-edit (token de admin)
• CLI: jenks admin ai-edit <slug|path> "<instruction>" [--apply]

Argumento	Tipo	Obligatorio	Notas
path	cadena	no
slug	cadena	no
instruction	cadena	sí
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).
content	cadena	no	Texto de archivo no guardado opcional desde el cual redactar (predeterminado: el archivo guardado).

curl -s -X POST https://jenksguo.xyz/api/admin/ai-edit \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"instruction":"<instruction>"}'

admin_deploy_status — Estado del despliegue

Ejecuciones recientes de CI (traducción → build → despliegue) con estado, rama, commit y enlaces.

• MCP: admin_deploy_status en https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/deploys?branch= (token de admin)
• CLI: jenks admin deploys

Argumento	Tipo	Obligatorio	Notas
branch	main · dev	no	main publica en jenksguo.xyz; dev previsualiza en dev.jenksguo.xyz (predeterminado main).

curl -s "https://jenksguo.xyz/api/admin/deploys" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_promote — Promocionar dev a producción

Fusiona la rama dev en main, publicando todo lo previsualizado en dev.jenksguo.xyz a jenksguo.xyz.

• MCP: admin_promote en https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/promote (token de admin)
• CLI: jenks admin promote

Argumento	Tipo	Obligatorio	Notas
message	cadena	no

curl -s -X POST https://jenksguo.xyz/api/admin/promote \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{}'