Skip to main content
Jenks Guo

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_brief en https://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_experience en https://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_entry en https://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_lenses en https://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_jenks en https://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_document en https://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_cvs en https://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_cv en https://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_arguments en https://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_argument en https://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_jenks en https://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_whoami en https://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_log en https://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_schema en https://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_files en https://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_file en https://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_validate en https://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_file en https://jenksguo.pages.dev/mcp/admin
  • REST: PUT /api/admin/file (agent token)
  • Alcance: content (+ publish para la rama main)
  • 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_file en https://jenksguo.pages.dev/mcp/admin
  • REST: DELETE /api/admin/file?path=&message=&branch= (agent token)
  • Alcance: content (+ publish para la rama main)
  • 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_changes en https://jenksguo.pages.dev/mcp/admin
  • REST: POST /api/admin/changes (agent token)
  • Alcance: content (+ publish para la rama main)
  • 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_edit en https://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_translation en https://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_translation en https://jenksguo.pages.dev/mcp/admin
  • REST: PUT /api/admin/translation (agent token)
  • Alcance: content (+ publish para la rama main)
  • 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_copy en https://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_copy en https://jenksguo.pages.dev/mcp/admin
  • REST: PUT /api/admin/copy (agent token)
  • Alcance: content (+ publish para la rama main)
  • 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_status en https://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_promote en https://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/.pdf servirá entonces el nuevo archivo.

  • MCP: admin_publish_cv en https://jenksguo.pages.dev/mcp/admin
  • REST: POST /api/admin/cv (agent token)
  • Alcance: content + media (+ publish para la rama main)
  • 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_media en https://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_media en https://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_media en https://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_media en https://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.