Serveurs

Serveur	URL	Authentification
Public	https://jenksguo.xyz/mcp	aucune
Admin	https://jenksguo.xyz/mcp/admin	Authorization: Bearer <admin token>
Local (stdio)	jenks mcp / jenks mcp --admin	env JENKSGUO_ADMIN_TOKEN pour l'admin

Transport : HTTP diffusible, 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.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":{}}}'

Outils publics

get_brief — Obtenir le brief de Jenks

Un brief d’une page en Markdown sur Jenks Guo : positionnement, rôle actuel, parcours, forces, langues, contact et comment aller plus loin. Commencez ici.

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

Aucun argument.

curl -s "https://jenksguo.xyz/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 de secteur, lentille de rôle ou type. Renvoie des formes courtes : titre, organisation, période, résumé, résultat clé, URL de la page.

• MCP: list_experience sur https://jenksguo.xyz/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.xyz/api/v1/entries"

get_entry — Obtenir une entrée

Description 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, importance pour les employeurs, résultats clés, compétences, liens de preuve.

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

Argument	Type	Obligatoire	Notes
slug	string	oui	Slug de l’entrée, p. 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.xyz/api/v1/entries/xero-developer-evangelist"

list_lenses — Lister les lentilles de rôle

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

• MCP: list_lenses sur https://jenksguo.xyz/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.xyz/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.xyz/mcp
• REST: GET /api/v1/search?q=
• CLI: jenks search "<query>"

Argument	Type	Obligatoire	Notes
query	string	oui

curl -s "https://jenksguo.xyz/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 (vision du monde).

• MCP: get_document sur https://jenksguo.xyz/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.xyz/api/v1/documents/credentials"

ask_jenks — Interroger l’assistant de Jenks

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

• MCP: ask_jenks sur https://jenksguo.xyz/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 précédents facultatifs.

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

Outils d’administration

admin_schema — Schéma de contenu

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

• MCP: admin_schema sur https://jenksguo.xyz/mcp/admin
• REST: GET /api/admin/schema (jeton admin)
• CLI: jenks admin schema

Aucun argument.

curl -s "https://jenksguo.xyz/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.xyz/mcp/admin
• REST: GET /api/admin/files?dir=&branch= (jeton admin)
• CLI: jenks admin ls [dir]

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

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

admin_read_file — Lire un fichier de contenu

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

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

Argument	Type	Obligatoire	Notes
path	string	non
slug	string	non
branch	main · dev	non	main publie sur jenksguo.xyz ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

curl -s "https://jenksguo.xyz/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 (commit). Renvoie une liste de problèmes (vide = valide).

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

Argument	Type	Obligatoire	Notes
path	string	oui
content	string	oui

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

Valider et valider (commit) 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.xyz, dev → dev.jenksguo.xyz) en quelques minutes.

• MCP: admin_write_file sur https://jenksguo.xyz/mcp/admin
• REST: PUT /api/admin/file (jeton admin)
• 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 sur jenksguo.xyz ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Supprimer un fichier de contenu

Supprimer un fichier de contenu (p. 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.xyz/mcp/admin
• REST: DELETE /api/admin/file?path=&message=&branch= (jeton admin)
• CLI: jenks admin rm <path> -m <message>

Argument	Type	Obligatoire	Notes
path	string	oui
message	string	oui
branch	main · dev	non	main publie sur jenksguo.xyz ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Valider plusieurs fichiers à la fois

Valider et valider (commit) plusieurs modifications de fichiers en UN seul commit. Chaque modification est {path, content} ou {path, delete: true}.

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

Argument	Type	Obligatoire	Notes
changes	array	oui
message	string	oui
branch	main · dev	non	main publie sur jenksguo.xyz ; dev prévisualise sur dev.jenksguo.xyz (par défaut 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 — Proposer une modification 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 — relisez, puis appelez admin_write_file.

• MCP: admin_ai_edit sur https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/ai-edit (jeton admin)
• 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 sur jenksguo.xyz ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).
content	string	non	Texte de fichier non enregistré facultatif à partir duquel rédiger (par défaut : le fichier enregistré).

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 — Statut de déploiement

Exécutions CI récentes (traduction → build → déploiement) avec statut, branche, commit et liens.

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

Argument	Type	Obligatoire	Notes
branch	main · dev	non	main publie sur jenksguo.xyz ; dev prévisualise sur dev.jenksguo.xyz (par défaut main).

curl -s "https://jenksguo.xyz/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 jenksguo.xyz.

• MCP: admin_promote sur https://jenksguo.xyz/mcp/admin
• REST: POST /api/admin/promote (jeton admin)
• CLI: jenks admin promote

Argument	Type	Obligatoire	Notes
message	string	non

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