Serveurs

Serveur	URL	Auth
Public	https://jenksguo.pages.dev/mcp	aucune
Admin	https://jenksguo.pages.dev/mcp/admin	Authorization: Bearer <agent token> (jgx_agt_…, à portée)
Local (stdio)	jenks mcp / jenks mcp --admin	env JENKSGUO_ADMIN_TOKEN pour l’admin

Transport : HTTP diffusable, sans état, JSON-RPC 2.0 via POST (protocole 2025-06-18). GET sur l’une ou l’autre URL renvoie un document de découverte. Nom du serveur jenksguo, version 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":{}}}'

Outils publics

get_brief — Obtenir le briefing de Jenks

Un briefing Markdown d’une page à propos de Jenks Guo : positionnement, rôle actuel, parcours, forces, langues, contact et comment aller plus loin. Commencez ici.

• MCP : get_brief sur https://jenksguo.pages.dev/mcp
• REST : GET /api/v1/brief
• CLI : jenks brief

Aucun argument.

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

list_experience — Lister l’expérience

Liste des expériences, projets, rôles communautaires et formations de Jenks (du plus récent au plus ancien), avec possibilité de filtrer par étiquette secteur, prisme de rôle ou type. Renvoie des formes courtes : titre, organisation, période, résumé, résultat clé, URL de page.

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

Argument	Type	Obligatoire	Notes
tag	it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative	non
lens	head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality	non
kind	experience · education · community · project	non
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

get_entry — Obtenir une entrée

Rédaction longue et complète d’une expérience, d’un projet, d’un rôle communautaire ou d’une formation par slug : aperçu, ce que Jenks a fait, réalisations, pourquoi cela compte pour les employeurs, résultats clés, compétences, liens de preuve.

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

Argument	Type	Obligatoire	Notes
slug	string	oui	Slug de l’entrée, ex. xero-developer-evangelist
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

list_lenses — Lister les prismes de rôle

Les prismes de rôle à travers lesquels les employeurs peuvent voir Jenks (Head of AI, solution architect, developer advocate, digital marketer, hospitality…) avec un pitch, des lacunes honnêtement reconnues et des décomptes de preuves.

• MCP : list_lenses sur https://jenksguo.pages.dev/mcp
• REST : GET /api/v1/lenses?locale=
• CLI : jenks lenses

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

search_jenks — Rechercher dans le corpus

Recherche par mots-clés dans chaque entrée et document. Renvoie les passages les plus pertinents avec leurs slugs.

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

Argument	Type	Obligatoire	Notes
query	string	oui

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

get_document — Obtenir un document

L’un des documents de référence de Jenks : profile (profil central), credentials (éducation, certifications), capabilities (carte capacité → preuves), talks (conférences, podcasts, écrits), thinking (point de vue : sept vues, chacune expliquée simplement avec exemples, plus d’autres convictions).

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

Argument	Type	Obligatoire	Notes
name	profile · credentials · capabilities · talks · thinking	oui
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

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

list_cvs — Lister les CV de Jenks

Le CV téléchargeable de Jenks (PDF) — le CV AI Lead — avec version, date, une URL PDF stable, une URL de téléchargement, une image d’aperçu et les versions antérieures. Pour les questions sur son expérience Web3, get_cv avec le slug web3 renvoie le CV AI and Web3 (non listé ici).

• MCP : list_cvs sur https://jenksguo.pages.dev/mcp
• REST : GET /api/v1/cv?locale=
• CLI : jenks cv

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/cv"

get_cv — Obtenir un CV

Un CV par slug : titre, résumé, version, l’URL PDF stable (toujours la version actuelle, ex. https://jenksguo.pages.dev/cv/ai.pdf), l’URL de téléchargement et toutes les versions. Utilisez ai pour le CV AI Lead ; utilisez web3 pour le CV AI and Web3 quand on demande son expérience Web3.

• MCP : get_cv sur https://jenksguo.pages.dev/mcp
• REST : GET /api/v1/cv/{slug}?locale=
• CLI : jenks cv <slug> [--download] [-o file.pdf]

Argument	Type	Obligatoire	Notes
slug	string	oui	ai (le CV AI Lead) ou web3 (le CV AI and Web3, pour les questions Web3)
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/cv/xero-developer-evangelist"

list_arguments — Lister les arguments en faveur de Jenks

Les arguments pour Jenks par capacité — AI transformation, agentic systems, leadership, enterprise integration, DevRel, Web3 partnerships et pilotage de programmes techniques transverses — chacun avec son énoncé, un modérateur et sa force.

• MCP : list_arguments sur https://jenksguo.pages.dev/mcp
• REST : GET /api/v1/arguments?locale=
• CLI : jenks argue

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/arguments"

get_argument — Obtenir un argument, avec objections

Un argument par slug : l’argument formel (prémisses → conclusion), les preuves chiffrées (slugs d’entrées), des statistiques de marché avec sources, des limites honnêtes, des objections équitables avec réponses, des attaques fallacieuses (logiques et informelles) avec répliques, et quand l’argument ne s’applique pas. À utiliser pour tester l’adéquation de Jenks, pas seulement pour la promouvoir.

• MCP : get_argument sur https://jenksguo.pages.dev/mcp
• REST : GET /api/v1/arguments/{slug}?locale=
• CLI : jenks argue <slug>

Argument	Type	Obligatoire	Notes
slug	string	oui	ai-transformation, agentic-systems, leadership, enterprise-integration, devrel, web3-partnerships ou technical-program-leadership
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).

curl -s "https://jenksguo.pages.dev/api/v1/arguments/xero-developer-evangelist"

ask_jenks — Interroger l’assistant de Jenks

Posez une question en langage naturel à l’assistant Ask Jenks (adéquation à un rôle, cadrage de conseil, conseils en AI transformation, récits STAR, gouvernance…). Il exécute ses propres outils sur le corpus et répond dans la langue demandée. Limité en débit.

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

Argument	Type	Obligatoire	Notes
question	string	oui
locale	en · zh · zh-hant · ja · fr · es · eo	non	Langue pour les champs traduits (par défaut en).
history	array	non	Tours antérieurs facultatifs.

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?"}'

Outils d’administration

admin_whoami — Qui suis-je

Vérifiez votre justificatif : qui vous êtes (e-mail SSO ou nom du jeton d’agent), vos portées, quand votre jeton expire, et si la publication (GitHub) est configurée.

• MCP : admin_whoami sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/whoami (agent token)
• Scope : read
• CLI : jenks admin whoami

Aucun argument.

curl -s "https://jenksguo.pages.dev/api/admin/whoami" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_audit_log — Journal d’audit

Actions d’admin récentes, de la plus récente à la plus ancienne : qui (e-mail SSO ou jeton d’agent), quoi, quels fichiers, branche, hôte et résultat. Un jeton d’agent ne voit que ses propres actions.

• MCP : admin_audit_log sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/audit?limit=&token= (agent token)
• Scope : read
• CLI : jenks admin audit [--limit 50]

Argument	Type	Obligatoire	Notes
limit	integer	non
token	string	non	Uniquement cet id de jeton d’agent (personnes uniquement)

curl -s "https://jenksguo.pages.dev/api/admin/audit" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_schema — Schéma de contenu

Le modèle de contenu : champs et règles des entrées, étiquettes, prismes, types, chemins inscriptibles, documents et conventions d’édition. À lire avant d’écrire.

• MCP : admin_schema sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/schema (agent token)
• Scope : read
• CLI : jenks admin schema

Aucun argument.

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

admin_list_files — Lister les fichiers de contenu

Lister les fichiers de contenu modifiables sur une branche (chemin, taille, sha), éventuellement dans un dossier comme content/corpus/experiences.

• MCP : admin_list_files sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/files?dir=&branch= (agent token)
• Scope : read
• CLI : jenks admin ls [dir]

Argument	Type	Obligatoire	Notes
dir	string	non	ex. content/corpus/projects (par défaut : tout le contenu)
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

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

admin_read_file — Lire un fichier de contenu

Lire la source Markdown/JSON brute d’un fichier de contenu (avec son sha). Passez path, ou slug pour une entrée, un prisme ou une compétence.

• MCP : admin_read_file sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/file?path=&slug=&branch= (agent token)
• Scope : read
• CLI : jenks admin get <slug|path>

Argument	Type	Obligatoire	Notes
path	string	non
slug	string	non
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

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

admin_validate — Valider une modification

Valider le contenu d’un fichier par rapport au schéma de contenu sans valider en dépôt. Renvoie une liste de problèmes (vide = valide).

• MCP : admin_validate sur https://jenksguo.pages.dev/mcp/admin
• REST : POST /api/admin/validate (agent token)
• Scope : read
• CLI : jenks admin validate <path> <file>

Argument	Type	Obligatoire	Notes
path	string	oui
content	string	oui

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 — Créer ou mettre à jour un fichier de contenu

Valider et valider en dépôt un fichier de contenu (création ou remplacement). La publication est automatique : la CI retraduit les entrées modifiées dans toutes les langues, reconstruit et déploie (main → jenksguo.pages.dev et jenksguo.xyz, dev → dev.jenksguo.xyz) en quelques minutes.

• MCP : admin_write_file sur https://jenksguo.pages.dev/mcp/admin
• REST : PUT /api/admin/file (agent token)
• Scope : content (+ publish pour la branche main)
• CLI : jenks admin put <path> <file> -m <message>

Argument	Type	Obligatoire	Notes
path	string	oui
content	string	oui
message	string	oui	Message de commit
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Supprimer un fichier de contenu

Supprimer un fichier de contenu (par ex. retirer une entrée) avec un message de commit. L’historique Git le rend récupérable.

• MCP : admin_delete_file sur https://jenksguo.pages.dev/mcp/admin
• REST : DELETE /api/admin/file?path=&message=&branch= (agent token)
• Scope : content (+ publish pour la branche main)
• CLI : jenks admin rm <path> -m <message>

Argument	Type	Obligatoire	Notes
path	string	oui
message	string	oui
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Valider plusieurs fichiers en une seule fois

Valider et valider en dépôt plusieurs modifications de fichiers comme UN seul commit. Chaque modification est {path, content} ou {path, delete: true}.

• MCP : admin_commit_changes sur https://jenksguo.pages.dev/mcp/admin
• REST : POST /api/admin/changes (agent token)
• Scope : content (+ publish pour la branche main)
• CLI : jenks admin commit <changes.json> -m <message>

Argument	Type	Obligatoire	Notes
changes	array	oui
message	string	oui
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Proposer une édition avec l’IA

Demandez au modèle du site de réécrire un fichier de contenu à partir d’une instruction en anglais simple. Renvoie le contenu proposé, un diff et les problèmes de validation. NE valide PAS en dépôt — relisez, puis appelez admin_write_file.

• MCP : admin_ai_edit sur https://jenksguo.pages.dev/mcp/admin
• REST : POST /api/admin/ai-edit (agent token)
• Scope : content
• CLI : jenks admin ai-edit <slug|path> "<instruction>" [--apply]

Argument	Type	Obligatoire	Notes
path	string	non
slug	string	non
instruction	string	oui
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).
content	string	non	Texte de fichier non enregistré facultatif à partir duquel proposer un brouillon (par défaut : le fichier enregistré).

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 — Lire une traduction

Un fichier de contenu dans une autre langue : les champs source en anglais, la traduction actuelle et son statut (à jour, obsolète, modifiée manuellement, manquante). Fonctionne pour les entrées, prismes, CV, arguments, pages de point de vue, credentials, talks et la documentation. Langues : zh, zh-hant, ja, fr, es, eo.

• MCP : admin_read_translation sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/translation?path=&slug=&locale=&branch= (agent token)
• Scope : read
• CLI : jenks admin tr get <slug|path> <locale>

Argument	Type	Obligatoire	Notes
path	string	non
slug	string	non
locale	zh · zh-hant · ja · fr · es · eo	oui
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

curl -s "https://jenksguo.pages.dev/api/admin/translation" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_write_translation — Éditer une traduction

Écrire le texte d’un fichier de contenu dans une autre langue (zh, zh-hant, ja, fr, es, eo) — par exemple un meilleur résumé en chinois. Donnez uniquement les champs à modifier ; lisez d’abord admin_read_translation pour les noms de champs. Le Markdown doit conserver les en-têtes, blocs de code et liens en anglais. L’édition est conservée jusqu’à ce que l’anglais change ; ensuite cette langue est retraduite automatiquement. L’anglais est la source : modifiez-le avec admin_write_file.

• MCP : admin_write_translation sur https://jenksguo.pages.dev/mcp/admin
• REST : PUT /api/admin/translation (agent token)
• Scope : content (+ publish pour la branche main)
• CLI : jenks admin tr put <slug|path> <locale> <fields.json> -m <message>

Argument	Type	Obligatoire	Notes
path	string	non
slug	string	non
locale	zh · zh-hant · ja · fr · es · eo	oui
fields	object	oui	ex. {"summary": "…", "body": "## …"}
message	string	non	Message de commit
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Lire les textes d’interface du site

Les textes d’interface du site dans une langue — menus, titres de pages, accroches d’une ligne, héros, boutons, descriptions SEO — sous forme clé → texte, avec l’anglais (et le chinois pour zh-hant) à côté. Filtrez avec un préfixe, ex. hero ou career.

• MCP : admin_read_copy sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/copy?locale=&prefix=&branch= (agent token)
• Scope : read
• CLI : jenks admin copy get <locale> [prefix]

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	oui
prefix	string	non
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

curl -s "https://jenksguo.pages.dev/api/admin/copy" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_write_copy — Éditer les textes d’interface du site

Modifier les textes d’interface dans une langue : values est clé → texte ("" supprime votre édition). en et zh sont les sources rédigées à la main : un changement en anglais est traduit automatiquement en ja, fr, es et eo — renseignez aussi zh. Une édition dans une autre langue est conservée jusqu’à ce que son texte source change. Conservez exactement les {placeholders}.

• MCP : admin_write_copy sur https://jenksguo.pages.dev/mcp/admin
• REST : PUT /api/admin/copy (agent token)
• Scope : content (+ publish pour la branche main)
• CLI : jenks admin copy set <locale> <key> "<text>" -m <message>

Argument	Type	Obligatoire	Notes
locale	en · zh · zh-hant · ja · fr · es · eo	oui
values	object	oui	ex. {"hero.sub": "…"}
message	string	non
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Statut des déploiements

Exécutions CI récentes (translate → build → deploy) avec statut, branche, commit et liens.

• MCP : admin_deploy_status sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/deploys?branch= (agent token)
• Scope : read
• CLI : jenks admin deploys

Argument	Type	Obligatoire	Notes
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

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

admin_promote — Promouvoir dev en production

Fusionner la branche dev dans main, publiant tout ce qui a été prévisualisé sur dev.jenksguo.xyz vers le site en direct (jenksguo.pages.dev et jenksguo.xyz).

• MCP : admin_promote sur https://jenksguo.pages.dev/mcp/admin
• REST : POST /api/admin/promote (agent token)
• Scope : publish
• CLI : jenks admin promote

Argument	Type	Obligatoire	Notes
message	string	non

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 — Publier une nouvelle version de CV

Téléverser un nouveau PDF pour un CV (ai, web3 ou un nouveau slug) et en faire la version actuelle en une étape : le PDF va dans la médiathèque, la version précédente passe dans l’historique du CV (toujours téléchargeable), et la modification est validée (la CI la publie). Image d’aperçu facultative et nouveau titre/résumé possibles. L’URL stable /cv/.pdf sert ensuite le nouveau fichier.

• MCP : admin_publish_cv sur https://jenksguo.pages.dev/mcp/admin
• REST : POST /api/admin/cv (agent token)
• Scope : content + media (+ publish pour la branche main)
• CLI : jenks admin cv publish <slug> <file.pdf> --cv-version 2026.10 [--preview /media/…]

Argument	Type	Obligatoire	Notes
slug	string	oui	ai, web3, ou un nouvel identifiant en kebab-case
version	string	oui	ex. 2026.10
filename	string	non
data	string	non	Octets PDF, base64
url	string	non	Alternative à data : URL https du PDF
preview	string	non	Facultatif : une image /media/… déjà téléversée de la page 1
title	string	non
summary	string	non
message	string	non	Message de commit
branch	main · dev	non	main publie le site en direct (jenksguo.pages.dev et son miroir jenksguo.xyz) ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Lister les médias

Lister les images, vidéos et PDF téléversés (du plus récent au plus ancien) : URL, type, taille, dimensions, texte alternatif, Markdown prêt à coller, et quelles entrées utilisent chaque fichier.

• MCP : admin_list_media sur https://jenksguo.pages.dev/mcp/admin
• REST : GET /api/admin/media?prefix=&cursor=&limit= (agent token)
• Scope : read
• CLI : jenks admin media ls [prefix]

Argument	Type	Obligatoire	Notes
prefix	string	non	Préfixe de clé tel que 2026/10
cursor	string	non
limit	integer	non

curl -s "https://jenksguo.pages.dev/api/admin/media" \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

admin_upload_media — Téléverser des médias

Stocker une image (webp, jpg, png, gif, avif, svg), une vidéo (mp4, webm) ou un PDF, jusqu’à 25 Mo, dans Cloudflare R2 et obtenir son URL publique /media/… et le Markdown. Envoyez des data base64 avec un filename, ou une url https publique à importer. Les fichiers sont publics par URL immédiatement ; référencez-les depuis le contenu avec admin_write_file. L’endpoint REST accepte aussi multipart/form-data (champ file).

• MCP : admin_upload_media sur https://jenksguo.pages.dev/mcp/admin
• REST : POST /api/admin/media (agent token)
• Scope : media
• CLI : jenks admin media upload <file|https-url> [--alt "…"]

Argument	Type	Obligatoire	Notes
filename	string	non	Nom de fichier d’origine ; devient la partie lisible de l’URL.
data	string	non	Octets du fichier, base64 (un préfixe d’URL data: est autorisé).
url	string	non	Alternative à data : une URL https que le serveur télécharge.
alt	string	non	Texte alternatif : ce que montre l’image, pour les lecteurs d’écran et le bot.
width	integer	non
height	integer	non

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 — Mettre à jour le texte alternatif d’un média

Modifier le texte alternatif stocké d’un fichier téléversé (l’alt par défaut lorsqu’il est inséré dans le contenu).

• MCP : admin_update_media sur https://jenksguo.pages.dev/mcp/admin
• REST : PATCH /api/admin/media (agent token)
• Scope : media
• CLI : jenks admin media alt <key> "<alt text>"

Argument	Type	Obligatoire	Notes
key	string	oui	Clé ou URL du média, ex. 2026/10/xero-talk-1a2b3c4d5e.webp
alt	string	oui

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 — Supprimer un média

Supprimer définitivement un fichier téléversé. Refusé tant que du contenu publié l’utilise, sauf si force est true. Non récupérable — à la différence des fichiers de contenu, il n’y a pas d’historique git.

• MCP : admin_delete_media sur https://jenksguo.pages.dev/mcp/admin
• REST : DELETE /api/admin/media?key=&force= (agent token)
• Scope : media
• CLI : jenks admin media rm <key> [--force]

Argument	Type	Obligatoire	Notes
key	string	oui
force	boolean	non

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>"}'