Documentación / reference
Herramientas MCP
Todas las herramientas en los servidores MCP públicos y de administración, con argumentos y ejemplos.
Servidores
| Servidor | URL | Autenticación |
|---|---|---|
| Público | https://jenksguo.pages.dev/mcp |
ninguna |
| Admin | https://jenksguo.pages.dev/mcp/admin |
Authorization: Bearer <agent token> (jgx_agt_…, con alcance) |
| 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.4.0.
curl -s https://jenksguo.pages.dev/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 en una página en Markdown sobre Jenks Guo: posicionamiento, rol actual, trayectoria profesional, fortalezas, idiomas, contacto y cómo profundizar. Empieza aquí.
- MCP:
get_briefenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/brief - CLI:
jenks brief
Sin argumentos.
curl -s "https://jenksguo.pages.dev/api/v1/brief"
list_experience — Listar experiencia
Lista las experiencias, proyectos, roles en la comunidad y educación de Jenks (los más recientes primero), opcionalmente filtrados 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_experienceenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/entries?tag=&lens=&kind=&locale= - CLI:
jenks list [--tag it] [--lens solution-architect] [--kind project]
| Argumento | Tipo | Requerido | 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 los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/entries"
get_entry — Obtener una entrada
Texto largo completo de una experiencia, proyecto, rol en la comunidad o educación por slug: panorama general, qué hizo Jenks, logros, por qué importa para empleadores, resultados clave, habilidades, enlaces de prueba.
- MCP:
get_entryenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/entries/{slug}?locale= - CLI:
jenks get <slug>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
slug |
string | sí | Slug de la entrada, p. ej. xero-developer-evangelist |
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/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 conteos de evidencia.
- MCP:
list_lensesenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/lenses?locale= - CLI:
jenks lenses
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/lenses"
search_jenks — Buscar en el corpus
Búsqueda por palabra clave en cada entrada y documento. Devuelve los pasajes con mejor coincidencia con sus slugs.
- MCP:
search_jenksenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/search?q= - CLI:
jenks search "<query>"
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
query |
string | sí |
curl -s "https://jenksguo.pages.dev/api/v1/search"
get_document — Obtener un documento
Uno de los documentos de referencia de Jenks: profile (perfil principal), credentials (educación, certificaciones), capabilities (mapa de capacidad → evidencia), talks (charlas, pódcasts, escritura), thinking (punto de vista: siete visiones, cada una explicada en palabras simples con ejemplos, más creencias adicionales).
- MCP:
get_documentenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/documents/{name}?locale= - CLI:
jenks doc <name>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
name |
profile · credentials · capabilities · talks · thinking |
sí | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/documents/credentials"
list_cvs — Listar los CV de Jenks
El CV descargable de Jenks (PDF) — el CV de AI Lead — con versión, fecha, una URL de PDF estable, una URL de descarga, una imagen de vista previa y versiones anteriores. Para preguntas sobre su experiencia en Web3, get_cv con el slug web3 devuelve el CV de AI y Web3 (no listado aquí).
- MCP:
list_cvsenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/cv?locale= - CLI:
jenks cv
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/cv"
get_cv — Obtener un CV
Un CV por slug: título, resumen, versión, la URL de PDF estable (siempre la versión actual, p. ej. https://jenksguo.pages.dev/cv/ai.pdf), la URL de descarga y todas las versiones. Usa ai para el CV de AI Lead; usa web3 para el CV de AI y Web3 cuando alguien pregunte por su experiencia en Web3.
- MCP:
get_cvenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/cv/{slug}?locale= - CLI:
jenks cv <slug> [--download] [-o file.pdf]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
slug |
string | sí | ai (el CV de AI Lead) o web3 (el CV de AI y Web3, para preguntas de Web3) |
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"
list_arguments — Exponer el caso a favor de Jenks
Los argumentos a favor de Jenks por capacidad — AI transformation, agentic systems, liderazgo, enterprise integration, DevRel, Web3 partnerships y liderazgo de programas técnicos entre proyectos — cada uno con su afirmación, calificador y solidez.
- MCP:
list_argumentsenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/arguments?locale= - CLI:
jenks argue
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/arguments"
get_argument — Obtener un argumento, con objeciones
Un argumento por slug: el argumento formal (premisas → conclusión), evidencia con números (slugs de entradas), estadísticas de mercado con fuentes, límites honestos, objeciones justas con respuestas, ataques falaces (formales e informales) con réplicas y cuándo el argumento no aplica. Úsalo para evaluar el encaje de Jenks, no solo para promoverlo.
- MCP:
get_argumentenhttps://jenksguo.pages.dev/mcp - REST:
GET /api/v1/arguments/{slug}?locale= - CLI:
jenks argue <slug>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
slug |
string | sí | ai-transformation, agentic-systems, leadership, enterprise-integration, devrel, web3-partnerships o technical-program-leadership |
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"
ask_jenks — Preguntar al asistente de Jenks
Hazle al asistente Ask Jenks una pregunta en lenguaje natural (encaje en un rol, alcance de consultoría, consejos de AI transformation, historias STAR, gobernanza…). Ejecuta sus propias herramientas sobre el corpus y responde en el idioma solicitado. Con límite de tasa.
- MCP:
ask_jenksenhttps://jenksguo.pages.dev/mcp - REST:
POST /api/v1/ask - CLI:
jenks ask "<question>"
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
question |
string | sí | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
no | Idioma para los campos traducidos (por defecto en). |
history |
array | no | Turnos anteriores opcionales. |
curl -s -X POST https://jenksguo.pages.dev/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_whoami — Quién soy
Comprueba tu credencial: quién eres (correo SSO o nombre del token de agente), tus alcances, cuándo expira tu token y si la publicación (GitHub) está configurada.
- MCP:
admin_whoamienhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/whoami(agent token) - Alcance:
read - CLI:
jenks admin whoami
Sin argumentos.
curl -s "https://jenksguo.pages.dev/api/admin/whoami" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_audit_log — Registro de auditoría
Acciones recientes de administración, de más nuevas a más antiguas: quién (correo SSO o token de agente), qué, qué archivos, rama, host y resultado. Un token de agente ve solo sus propias acciones.
- MCP:
admin_audit_logenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/audit?limit=&token=(agent token) - Alcance:
read - CLI:
jenks admin audit [--limit 50]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
limit |
integer | no | |
token |
string | no | Solo este id de token de agente (personas únicamente) |
curl -s "https://jenksguo.pages.dev/api/admin/audit" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_schema — Esquema de contenido
El modelo de contenido: campos y reglas de las entradas, etiquetas, lentes, tipos, rutas editables, documentos y convenciones de edición. Léelo antes de escribir.
- MCP:
admin_schemaenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/schema(agent token) - Alcance:
read - CLI:
jenks admin schema
Sin argumentos.
curl -s "https://jenksguo.pages.dev/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_filesenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/files?dir=&branch=(agent token) - Alcance:
read - CLI:
jenks admin ls [dir]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
dir |
string | no | p. ej. content/corpus/projects (por defecto: todo el contenido) |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s "https://jenksguo.pages.dev/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_fileenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/file?path=&slug=&branch=(agent token) - Alcance:
read - CLI:
jenks admin get <slug|path>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | no | |
slug |
string | no | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s "https://jenksguo.pages.dev/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 hacer commit. Devuelve una lista de problemas (vacía = válido).
- MCP:
admin_validateenhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/validate(agent token) - Alcance:
read - CLI:
jenks admin validate <path> <file>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | sí | |
content |
string | sí |
curl -s -X POST https://jenksguo.pages.dev/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 hace commit de 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.pages.dev y jenksguo.xyz, dev → dev.jenksguo.xyz) en unos minutos.
- MCP:
admin_write_fileenhttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/file(agent token) - Alcance:
content(+publishpara la ramamain) - CLI:
jenks admin put <path> <file> -m <message>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | sí | |
content |
string | sí | |
message |
string | sí | Mensaje de commit |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s -X PUT https://jenksguo.pages.dev/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_fileenhttps://jenksguo.pages.dev/mcp/admin - REST:
DELETE /api/admin/file?path=&message=&branch=(agent token) - Alcance:
content(+publishpara la ramamain) - CLI:
jenks admin rm <path> -m <message>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | sí | |
message |
string | sí | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s -X DELETE https://jenksguo.pages.dev/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 — Hacer commit de varios archivos a la vez
Valida y hace commit de varios cambios de archivos como UN solo commit. Cada cambio es {path, content} o {path, delete: true}.
- MCP:
admin_commit_changesenhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/changes(agent token) - Alcance:
content(+publishpara la ramamain) - CLI:
jenks admin commit <changes.json> -m <message>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
changes |
array | sí | |
message |
string | sí | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s -X POST https://jenksguo.pages.dev/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
Pídele 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 hace commit — revisa y luego llama a admin_write_file.
- MCP:
admin_ai_editenhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/ai-edit(agent token) - Alcance:
content - CLI:
jenks admin ai-edit <slug|path> "<instruction>" [--apply]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | no | |
slug |
string | no | |
instruction |
string | sí | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
content |
string | no | Texto de archivo no guardado opcional desde el cual redactar (por defecto: el archivo guardado). |
curl -s -X POST https://jenksguo.pages.dev/api/admin/ai-edit \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"instruction":"<instruction>"}'
admin_read_translation — Leer una traducción
Un archivo de contenido en otro idioma: los campos fuente en inglés, la traducción actual y su estado (actual, desactualizada, editada a mano, ausente). Funciona para entradas, lentes, CV, argumentos, páginas de punto de vista, credenciales, charlas y la documentación. Idiomas: zh, zh-hant, ja, fr, es, eo.
- MCP:
admin_read_translationenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/translation?path=&slug=&locale=&branch=(agent token) - Alcance:
read - CLI:
jenks admin tr get <slug|path> <locale>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | no | |
slug |
string | no | |
locale |
zh · zh-hant · ja · fr · es · eo |
sí | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s "https://jenksguo.pages.dev/api/admin/translation" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_write_translation — Editar una traducción
Escribe el texto de un archivo de contenido en otro idioma (zh, zh-hant, ja, fr, es, eo) — por ejemplo, un mejor resumen en chino. Indica solo los campos a cambiar; primero lee admin_read_translation para los nombres de campos. El Markdown debe mantener los encabezados en inglés, los bloques de código y los enlaces. La edición se conserva hasta que cambie el inglés; entonces ese idioma se traduce de nuevo automáticamente. El inglés es la fuente: cámbialo con admin_write_file.
- MCP:
admin_write_translationenhttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/translation(agent token) - Alcance:
content(+publishpara la ramamain) - CLI:
jenks admin tr put <slug|path> <locale> <fields.json> -m <message>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
path |
string | no | |
slug |
string | no | |
locale |
zh · zh-hant · ja · fr · es · eo |
sí | |
fields |
object | sí | p. ej. {"summary": "…", "body": "## …"} |
message |
string | no | Mensaje de commit |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/translation \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"locale":"<locale>","fields":"<fields>"}'
admin_read_copy — Leer textos de la interfaz del sitio
Los textos de la interfaz del sitio en un idioma — menús, títulos de página, las introducciones de una línea, el titular del hero, botones, descripciones SEO — como clave → texto, con el inglés (y chino para zh-hant) al lado. Filtra con un prefijo, p. ej. hero o career.
- MCP:
admin_read_copyenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/copy?locale=&prefix=&branch=(agent token) - Alcance:
read - CLI:
jenks admin copy get <locale> [prefix]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
sí | |
prefix |
string | no | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s "https://jenksguo.pages.dev/api/admin/copy" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_write_copy — Editar textos de la interfaz del sitio
Cambia los textos de la interfaz en un idioma: values es clave → texto ("" elimina tu edición). en y zh son las fuentes escritas a mano: un cambio en inglés se traduce a ja, fr, es y eo automáticamente — configura también zh. Una edición en otro idioma se conserva hasta que cambie su texto fuente. Mantén {placeholders} exactamente.
- MCP:
admin_write_copyenhttps://jenksguo.pages.dev/mcp/admin - REST:
PUT /api/admin/copy(agent token) - Alcance:
content(+publishpara la ramamain) - CLI:
jenks admin copy set <locale> <key> "<text>" -m <message>
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
sí | |
values |
object | sí | p. ej. {"hero.sub": "…"} |
message |
string | no | |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s -X PUT https://jenksguo.pages.dev/api/admin/copy \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"locale":"<locale>","values":"<values>"}'
admin_deploy_status — Estado de despliegue
Ejecuciones recientes de CI (translate → build → deploy) con estado, rama, commit y enlaces.
- MCP:
admin_deploy_statusenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/deploys?branch=(agent token) - Alcance:
read - CLI:
jenks admin deploys
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s "https://jenksguo.pages.dev/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 al sitio en vivo (jenksguo.pages.dev y jenksguo.xyz).
- MCP:
admin_promoteenhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/promote(agent token) - Alcance:
publish - CLI:
jenks admin promote
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
message |
string | no |
curl -s -X POST https://jenksguo.pages.dev/api/admin/promote \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
admin_publish_cv — Publicar una nueva versión del CV
Sube un nuevo PDF para un CV (ai, web3 o un slug nuevo) y conviértelo en la versión actual en un solo paso: el PDF va a la biblioteca de medios, la versión anterior pasa al historial del CV (sigue siendo descargable) y se hace commit del cambio (CI lo publica). Imagen de vista previa y nuevo título/resumen opcionales. La URL estable /cv/
- MCP:
admin_publish_cvenhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/cv(agent token) - Alcance:
content+media(+publishpara la ramamain) - CLI:
jenks admin cv publish <slug> <file.pdf> --cv-version 2026.10 [--preview /media/…]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
slug |
string | sí | ai, web3, o un id nuevo en kebab-case |
version |
string | sí | p. ej. 2026.10 |
filename |
string | no | |
data |
string | no | Bytes del PDF, base64 |
url |
string | no | Alternativa a data: URL https del PDF |
preview |
string | no | Opcional: una imagen ya subida /media/… de la página 1 |
title |
string | no | |
summary |
string | no | |
message |
string | no | Mensaje de commit |
branch |
main · dev |
no | main publica el sitio en vivo (jenksguo.pages.dev y su espejo jenksguo.xyz); dev previsualiza en dev.jenksguo.xyz (por defecto main). |
curl -s -X POST https://jenksguo.pages.dev/api/admin/cv \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"slug":"<slug>","version":"<version>"}'
admin_list_media — Listar medios
Lista imágenes, videos y PDFs subidos (los más recientes primero): URL, tipo, tamaño, dimensiones, texto alternativo, Markdown listo para pegar y qué entradas usan cada archivo.
- MCP:
admin_list_mediaenhttps://jenksguo.pages.dev/mcp/admin - REST:
GET /api/admin/media?prefix=&cursor=&limit=(agent token) - Alcance:
read - CLI:
jenks admin media ls [prefix]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
prefix |
string | no | Prefijo de clave como 2026/10 |
cursor |
string | no | |
limit |
integer | no |
curl -s "https://jenksguo.pages.dev/api/admin/media" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_upload_media — Subir medios
Almacena una imagen (webp, jpg, png, gif, avif, svg), video (mp4, webm) o PDF, hasta 25 MB, en Cloudflare R2 y obtiene su URL pública /media/… y Markdown. Envía data base64 con un filename, o una url https pública para importar. Los archivos son públicos por URL de inmediato; hace referencia a ellos desde el contenido con admin_write_file. El endpoint REST también acepta multipart/form-data (campo file).
- MCP:
admin_upload_mediaenhttps://jenksguo.pages.dev/mcp/admin - REST:
POST /api/admin/media(agent token) - Alcance:
media - CLI:
jenks admin media upload <file|https-url> [--alt "…"]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
filename |
string | no | Nombre de archivo original; se convierte en la parte legible de la URL. |
data |
string | no | Bytes del archivo, base64 (se permite un prefijo data: URL). |
url |
string | no | Alternativa a data: una URL https que el servidor descarga. |
alt |
string | no | Texto alternativo: lo que muestra la imagen, para lectores de pantalla y el bot. |
width |
integer | no | |
height |
integer | no |
curl -s -X POST https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
admin_update_media — Actualizar el texto alternativo de un medio
Cambia el texto alternativo almacenado de un archivo subido (el alt por defecto cuando se inserta en contenido).
- MCP:
admin_update_mediaenhttps://jenksguo.pages.dev/mcp/admin - REST:
PATCH /api/admin/media(agent token) - Alcance:
media - CLI:
jenks admin media alt <key> "<alt text>"
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
key |
string | sí | Clave o URL del medio, p. ej. 2026/10/xero-talk-1a2b3c4d5e.webp |
alt |
string | sí |
curl -s -X PATCH https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"key":"<key>","alt":"<alt>"}'
admin_delete_media — Eliminar medios
Elimina permanentemente un archivo subido. Se rechaza mientras contenido publicado aún lo use, a menos que force sea true. No recuperable — a diferencia de los archivos de contenido, no hay historial de git.
- MCP:
admin_delete_mediaenhttps://jenksguo.pages.dev/mcp/admin - REST:
DELETE /api/admin/media?key=&force=(agent token) - Alcance:
media - CLI:
jenks admin media rm <key> [--force]
| Argumento | Tipo | Requerido | Notas |
|---|---|---|---|
key |
string | sí | |
force |
boolean | no |
curl -s -X DELETE https://jenksguo.pages.dev/api/admin/media \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"key":"<key>"}'
.mdEsta página está traducida con ayuda de IA; los títulos oficiales permanecen en inglés.