@takuhon/core 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -3697,20 +3697,69 @@ declare class ConflictError extends StorageError {
  * snapshot always renders the same markup, so both rendering surfaces (the
  * static HTML export and the React profile) and their tests stay in lockstep.
  *
+ * The card paints an **opaque background rectangle** first, so it stays legible
+ * wherever it is embedded — including a GitHub README served through the Camo
+ * image proxy, where no surrounding page styles apply and a transparent card
+ * would render invisibly on a dark theme. The colour set is supplied by a
+ * {@link Palette}: {@link renderActivitySvg} defaults to {@link LIGHT_PALETTE},
+ * and a transport (a Worker route, the CLI build) can pass {@link DARK_PALETTE}
+ * to serve a dark variant. Both palettes are plain data, so the render stays
+ * deterministic.
+ *
  * Every snapshot-derived string (language names, dates) is XML-escaped before
  * it reaches the markup: language names come from an external API and are
  * treated as untrusted. An empty snapshot (no metric fields) renders to `''`
  * so callers can omit the section with a truthiness check.
  */
 
+/**
+ * Colour set for an activity card. Kept as plain data (no CSS variables, no
+ * `currentColor`) so the rendered SVG is fully self-contained and legible when
+ * served as an image through Camo, where no page styles apply.
+ */
+interface Palette {
+    /** Fill of the opaque background rectangle behind the whole card. */
+    background: string;
+    /** Primary text (language legend, coding-time figure). */
+    text: string;
+    /** Secondary text (captions, rank score, "Last synced"). */
+    muted: string;
+    /** Accent fill (the rank badge disc). */
+    accent: string;
+    /**
+     * Order-based palette for the language bar and its legend chips; entries are
+     * assigned to the top languages in order, and anything past the end (or the
+     * folded "Other" segment) uses {@link Palette.otherColor}.
+     */
+    languageColors: readonly string[];
+    /** Colour of the folded "Other" language segment. */
+    otherColor: string;
+    /** Five-step contribution heat ramp, lowest (zero) first. */
+    heatColors: readonly string[];
+}
+/** Default palette: dark text on an opaque white card. */
+declare const LIGHT_PALETTE: Palette;
+/**
+ * Dark variant: light text on an opaque dark card (tuned to read on a GitHub
+ * dark-theme README). The heat ramp stays in the card's blue family rather than
+ * borrowing GitHub's green, so light and dark cards look like the same design.
+ */
+declare const DARK_PALETTE: Palette;
+/** Options accepted by {@link renderActivitySvg}. */
+interface RenderActivitySvgOptions {
+    /** Colour set to render with. Defaults to {@link LIGHT_PALETTE}. */
+    palette?: Palette;
+}
 /**
  * Render the activity snapshot as a self-contained `<svg>` string, or `''`
  * when the snapshot carries no metric data (so callers can omit the section).
  * Sections render independently — whatever the snapshot holds is shown, the
  * rest is left out — and `lastSyncedAt`'s date is always stamped in the footer
- * so staleness stays visible.
+ * so staleness stays visible. Colours come from `options.palette`
+ * ({@link LIGHT_PALETTE} by default); the card always paints an opaque
+ * background so it stays legible when embedded as an image.
  */
-declare function renderActivitySvg(snapshot: ActivitySnapshot): string;
+declare function renderActivitySvg(snapshot: ActivitySnapshot, options?: RenderActivitySvgOptions): string;
 
 /**
  * Résumé / CV projection of a profile.
@@ -3801,6 +3850,115 @@ interface CvDocument {
  */
 declare function deriveCv(localized: LocalizedTakuhon): CvDocument;
 
+/**
+ * MCP (Model Context Protocol) projection of a profile.
+ *
+ * This module describes how a takuhon profile is exposed to an AI agent as a
+ * set of read-only MCP tools and resources, and how each one is answered from a
+ * profile document — *without* committing to a transport (stdio / HTTP) or to
+ * any MCP SDK.
+ *
+ * The split mirrors the rest of core: deciding *what* to expose and *what it
+ * returns* is a pure, deterministic projection over the canonical document
+ * (exactly like {@link generateJsonLd}), so it lives here in `@takuhon/core` and
+ * stays runtime-free (spec §2.3). The transport, JSON-RPC framing, and server
+ * lifecycle are runtime-aware; they live in `@takuhon/mcp` and the CLI /
+ * Cloudflare adapters, which call the pure executors below.
+ *
+ * Everything here is read-only. No tool or resource touches the admin surface,
+ * and every answer passes through {@link applyPublicPrivacyFilter}, so an MCP
+ * client sees exactly what `GET /api/profile`, `GET /api/jsonld`, `GET
+ * /api/schema`, and `GET /takuhon.json` already expose — no more.
+ *
+ * The catalog ({@link MCP_TOOLS} / {@link MCP_RESOURCES}) is plain data with no
+ * SDK dependency, so the `@takuhon/mcp` wiring can register it against the
+ * official `@modelcontextprotocol/sdk` and later be swapped to a hand-rolled
+ * dispatcher without touching this file.
+ */
+
+/**
+ * Profile sections a `get_section` call may request: the content-bearing keys
+ * of a locale-resolved profile (the spec §6 data sections). `settings`,
+ * `meta`, `schemaVersion`, and `resolvedLocale` are intentionally excluded —
+ * they are configuration / bookkeeping, not profile content an agent reads.
+ */
+declare const MCP_PROFILE_SECTIONS: readonly ["profile", "links", "careers", "projects", "skills", "certifications", "memberships", "volunteering", "honors", "education", "publications", "languages", "courses", "patents", "testScores", "recommendations", "contact"];
+/** One of the {@link MCP_PROFILE_SECTIONS} a `get_section` call accepts. */
+type McpProfileSection = (typeof MCP_PROFILE_SECTIONS)[number];
+/** A JSON Schema (draft 2020-12) object describing a tool's input arguments. */
+type McpInputSchema = Readonly<Record<string, unknown>>;
+/** A read-only MCP tool definition — plain data, no SDK dependency. */
+interface McpToolDefinition {
+    /** Stable tool id used in `tools/call`. */
+    name: string;
+    /** Human-readable title for display. */
+    title: string;
+    /** What the tool returns; shown to the agent when it chooses a tool. */
+    description: string;
+    /** JSON Schema for the tool's `arguments` object. */
+    inputSchema: McpInputSchema;
+}
+/** A read-only MCP resource definition — plain data, no SDK dependency. */
+interface McpResourceDefinition {
+    /** Stable resource URI used in `resources/read`. */
+    uri: string;
+    name: string;
+    title: string;
+    description: string;
+    /** MIME type of the resource contents. */
+    mimeType: string;
+}
+/** Result of {@link executeMcpTool}: the structured value the tool produced. */
+interface McpToolResult {
+    /**
+     * The JSON value the tool produced — already normalized, locale-resolved, and
+     * privacy-filtered. The transport layer serializes this to MCP wire content.
+     */
+    data: unknown;
+    /** Locale the result was resolved at, when the tool resolved one. */
+    resolvedLocale?: string;
+}
+/** Result of {@link readMcpResource}: one resource's contents. */
+interface McpResourceResult {
+    uri: string;
+    mimeType: string;
+    /** The JSON value of the resource. The transport layer serializes it. */
+    data: unknown;
+}
+/**
+ * Thrown by {@link executeMcpTool} / {@link readMcpResource} for an unknown
+ * tool/resource name or invalid arguments. The transport layer maps it to the
+ * appropriate MCP error (a JSON-RPC error for a malformed request, or an
+ * `isError` tool result for a bad argument) — core stays transport-agnostic.
+ */
+declare class McpRequestError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** The read-only tools an MCP client may call against the profile. */
+declare const MCP_TOOLS: readonly McpToolDefinition[];
+/** The read-only resources an MCP client may read. */
+declare const MCP_RESOURCES: readonly McpResourceDefinition[];
+/**
+ * Execute a read-only MCP tool against a profile document.
+ *
+ * `profile` is the raw validated {@link Takuhon} (the transport layer loaded it
+ * from KV / a file). Locale-aware tools normalize, locale-resolve, and
+ * privacy-filter it exactly as `GET /api/profile` does, then project the
+ * requested view. Pure and deterministic — no clock, no randomness, no I/O.
+ *
+ * @throws {McpRequestError} for an unknown tool name or invalid arguments.
+ */
+declare function executeMcpTool(name: string, args: Readonly<Record<string, unknown>>, profile: Takuhon): McpToolResult;
+/**
+ * Read a read-only MCP resource from a profile document. Pure and
+ * deterministic.
+ *
+ * @throws {McpRequestError} for an unknown resource URI.
+ */
+declare function readMcpResource(uri: string, profile: Takuhon): McpResourceResult;
+
 /**
  * Image-asset helpers for uploaded media (avatars, project images): magic-byte
  * type detection, header-only dimension / frame reading, and metadata stripping
@@ -3901,4 +4059,4 @@ declare function stripImageMetadata(bytes: Uint8Array, mime: AcceptedImageMime):
  */
 declare const SCHEMA_VERSION = "0.5.0";
 
-export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, type Education, type ExportOptions, type ExportedTakuhon, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Patent, type PatentStatus, type Profile, type Project, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };
+export { ACCEPTED_IMAGE_MIME_TYPES, type AcceptedImageMime, type ActivitySettings, type ActivitySnapshot, type ActivityStorage, type Address, type AssetOptions, type AssetRecord, type Avatar, type Career, type Certification, type CodingTime, ConflictError, type Contact, type ContentLicense, type ContentLicenseAttribution, type ContributionCalendar, type ContributionDay, type Course, type CvDocument, type CvHeader, type CvSection, type CvSectionKind, DARK_PALETTE, type Education, type ExportOptions, type ExportedTakuhon, type Honor, IMAGE_EXTENSIONS, type ImageInfo, ImportError, type Iso3166Alpha2, type IsoDateTime, LIGHT_PALETTE, type Language, type LanguageBreakdown, type LanguageProficiency, type Link, type LinkBuiltin, type LinkCustom, type LinkType, type LocaleTag, type LocalizedAddress, type LocalizedAvatar, type LocalizedBody, type LocalizedCareer, type LocalizedCertification, type LocalizedCourse, type LocalizedEducation, type LocalizedHonor, type LocalizedLanguage, type LocalizedLink, type LocalizedLinkBuiltin, type LocalizedLinkCustom, type LocalizedMembership, type LocalizedPatent, type LocalizedProfile, type LocalizedProject, type LocalizedPublication, type LocalizedRecommendation, type LocalizedRecommendationAuthor, type LocalizedTakuhon, type LocalizedTestScore, type LocalizedTitle, type LocalizedVolunteering, MAX_IMAGE_BYTES, MAX_IMAGE_DIMENSION, MAX_IMAGE_FRAMES, MCP_PROFILE_SECTIONS, MCP_RESOURCES, MCP_TOOLS, type McpInputSchema, type McpProfileSection, McpRequestError, type McpResourceDefinition, type McpResourceResult, type McpToolDefinition, type McpToolResult, type Membership, type Meta, type MetaPrivacy, type Migration, MigrationError, type NormalizedTakuhon, NotFoundError, type Palette, type Patent, type PatentStatus, type Profile, type Project, type Publication, RANK_FULL_CODING_HOURS, RANK_FULL_CONTRIBUTIONS, RANK_TIER_THRESHOLDS, type RankInput, type RankTier, type RankTierLabel, type Recommendation, type RecommendationAuthor, type RenderActivitySvgOptions, SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type Schema, type Settings, type Skill, type Slug, StorageError, type Takuhon, type TakuhonAssetStorage, type TakuhonStorage, type TestScore, type ValidationError, type ValidationResult, type Volunteering, type YearMonth, applyPublicPrivacyFilter, computeLanguagePercentages, deriveCv, deriveRankTier, detectImageMime, executeMcpTool, exportTakuhon, formatCodingTime, generateJsonLd, generatePersonJsonLd, generateProfilePageJsonLd, importTakuhon, isActivitySnapshot, migrateTakuhon, migrations, normalize, readImageInfo, readMcpResource, renderActivitySvg, resolveLocale, schema, stripImageMetadata, validate };

package/dist/index.js

@@ -11413,18 +11413,30 @@ function deriveRankTier(input) {
 var WIDTH = 520;
 var PAD = 16;
 var INNER = WIDTH - PAD * 2;
-var TEXT_COLOR = "#1a1a1a";
-var MUTED_COLOR = "#666666";
-var ACCENT_COLOR = "#0b5fff";
 var FONT_FAMILY = "system-ui,-apple-system,Segoe UI,Roboto,sans-serif";
-var LANGUAGE_COLORS = ["#0b5fff", "#7c3aed", "#059669", "#d97706", "#dc2626", "#0891b2"];
-var OTHER_COLOR = "#9ca3af";
 var MAX_LANGUAGES = 6;
-var HEAT_COLORS = ["#ebedf0", "#cce0ff", "#99c2ff", "#4d8aff", "#0b5fff"];
 var CELL = 7;
 var CELL_PITCH = 9;
 var CALENDAR_ROWS = 7;
 var MAX_CALENDAR_DAYS = 53 * CALENDAR_ROWS;
+var LIGHT_PALETTE = {
+  background: "#ffffff",
+  text: "#1a1a1a",
+  muted: "#666666",
+  accent: "#0b5fff",
+  languageColors: ["#0b5fff", "#7c3aed", "#059669", "#d97706", "#dc2626", "#0891b2"],
+  otherColor: "#9ca3af",
+  heatColors: ["#ebedf0", "#cce0ff", "#99c2ff", "#4d8aff", "#0b5fff"]
+};
+var DARK_PALETTE = {
+  background: "#0d1117",
+  text: "#e6edf3",
+  muted: "#9198a1",
+  accent: "#4493f8",
+  languageColors: ["#4493f8", "#a371f7", "#3fb950", "#d29922", "#f85149", "#39c5cf"],
+  otherColor: "#6e7681",
+  heatColors: ["#161b22", "#0a2c5e", "#11468f", "#1f6fdb", "#4493f8"]
+};
 function escapeXml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
@@ -11441,23 +11453,23 @@ function text(x, y, content, opts) {
   const anchor = opts.anchor !== void 0 ? ` text-anchor="${opts.anchor}"` : "";
   return `<text x="${String(x)}" y="${String(y)}" font-family="${FONT_FAMILY}" font-size="${String(opts.size)}" fill="${opts.fill}"${weight}${anchor}>${escapeXml(content)}</text>`;
 }
-function caption(x, y, label) {
-  return text(x, y, label, { size: 12, fill: MUTED_COLOR, weight: 600 });
+function caption(x, y, label, fill) {
+  return text(x, y, label, { size: 12, fill, weight: 600 });
 }
 function rect(x, y, w, h, fill, rx = 0) {
   const corner = rx > 0 ? ` rx="${String(rx)}"` : "";
   return `<rect x="${String(round2(x))}" y="${String(y)}" width="${String(round2(w))}" height="${String(h)}" fill="${fill}"${corner}/>`;
 }
-function languageSegments(languages) {
+function languageSegments(languages, palette) {
   const segments = languages.slice(0, MAX_LANGUAGES).map((l, i) => ({
     name: l.name,
     percent: l.percent,
-    color: LANGUAGE_COLORS[i] ?? OTHER_COLOR
+    color: palette.languageColors[i] ?? palette.otherColor
   }));
   const rest = languages.slice(MAX_LANGUAGES);
   if (rest.length > 0) {
     const percent = round2(rest.reduce((sum, l) => sum + l.percent, 0));
-    segments.push({ name: "Other", percent, color: OTHER_COLOR });
+    segments.push({ name: "Other", percent, color: palette.otherColor });
   }
   return segments.filter((s) => s.percent > 0);
 }
@@ -11465,7 +11477,8 @@ function heatLevel(count, max) {
   if (count <= 0) return 0;
   return Math.min(4, Math.max(1, Math.ceil(count / max * 4)));
 }
-function renderActivitySvg(snapshot) {
+function renderActivitySvg(snapshot, options = {}) {
+  const palette = options.palette ?? LIGHT_PALETTE;
   const hasLanguages = snapshot.languages !== void 0 && snapshot.languages.length > 0;
   const hasContributions = snapshot.contributions !== void 0 && snapshot.contributions.days.length > 0;
   const hasCodingTime = snapshot.codingTime !== void 0;
@@ -11474,9 +11487,9 @@ function renderActivitySvg(snapshot) {
   const parts = [];
   let y = PAD;
   if (hasLanguages && snapshot.languages) {
-    const segments = languageSegments(snapshot.languages);
+    const segments = languageSegments(snapshot.languages, palette);
     const total = segments.reduce((sum, s) => sum + s.percent, 0);
-    parts.push(caption(PAD, y + 11, "Languages"));
+    parts.push(caption(PAD, y + 11, "Languages", palette.muted));
     y += 22;
     let x = PAD;
     for (const segment of segments) {
@@ -11493,7 +11506,7 @@ function renderActivitySvg(snapshot) {
       parts.push(
         text(cx + 16, cy + 9, `${segment.name} ${String(segment.percent)}%`, {
           size: 12,
-          fill: TEXT_COLOR
+          fill: palette.text
         })
       );
     });
@@ -11503,13 +11516,18 @@ function renderActivitySvg(snapshot) {
     const days = snapshot.contributions.days.slice(-MAX_CALENDAR_DAYS);
     const max = days.reduce((m, d) => Math.max(m, d.count), 1);
     parts.push(
-      caption(PAD, y + 11, `Contributions \xB7 ${groupDigits(snapshot.contributions.total)}`)
+      caption(
+        PAD,
+        y + 11,
+        `Contributions \xB7 ${groupDigits(snapshot.contributions.total)}`,
+        palette.muted
+      )
     );
     y += 22;
     days.forEach((day, i) => {
       const column = Math.floor(i / CALENDAR_ROWS);
       const row = i % CALENDAR_ROWS;
-      const fill = HEAT_COLORS[heatLevel(day.count, max)] ?? HEAT_COLORS[0];
+      const fill = palette.heatColors[heatLevel(day.count, max)] ?? palette.heatColors[0];
       parts.push(rect(PAD + column * CELL_PITCH, y + row * CELL_PITCH, CELL, CELL, fill, 1.5));
     });
     y += CALENDAR_ROWS * CELL_PITCH - (CELL_PITCH - CELL) + 12;
@@ -11518,21 +11536,21 @@ function renderActivitySvg(snapshot) {
     const rankX = PAD + INNER - 120;
     if (hasCodingTime && snapshot.codingTime) {
       const t = snapshot.codingTime;
-      parts.push(caption(PAD, y + 11, "Coding time"));
+      parts.push(caption(PAD, y + 11, "Coding time", palette.muted));
       parts.push(
         text(PAD, y + 38, `${groupDigits(t.hours)}h ${String(t.minutes)}m`, {
           size: 22,
-          fill: TEXT_COLOR,
+          fill: palette.text,
           weight: 700
         })
       );
     }
     if (hasRank && snapshot.rank) {
       const rank = snapshot.rank;
-      parts.push(caption(rankX, y + 11, "Rank"));
+      parts.push(caption(rankX, y + 11, "Rank", palette.muted));
       const centerY = y + 32;
       parts.push(
-        `<circle cx="${String(rankX + 14)}" cy="${String(centerY)}" r="14" fill="${ACCENT_COLOR}"/>`
+        `<circle cx="${String(rankX + 14)}" cy="${String(centerY)}" r="14" fill="${palette.accent}"/>`
       );
       parts.push(
         `<text x="${String(rankX + 14)}" y="${String(centerY)}" font-family="${FONT_FAMILY}" font-size="14" font-weight="700" fill="#ffffff" text-anchor="middle" dominant-baseline="central">${escapeXml(rank.tier)}</text>`
@@ -11540,7 +11558,7 @@ function renderActivitySvg(snapshot) {
       parts.push(
         text(rankX + 36, centerY + 4, `score ${String(rank.score)}`, {
           size: 12,
-          fill: MUTED_COLOR
+          fill: palette.muted
         })
       );
     }
@@ -11549,13 +11567,14 @@ function renderActivitySvg(snapshot) {
   parts.push(
     text(WIDTH - PAD, y + 11, `Last synced ${snapshot.lastSyncedAt.slice(0, 10)}`, {
       size: 11,
-      fill: MUTED_COLOR,
+      fill: palette.muted,
       anchor: "end"
     })
   );
   y += 22;
   const height = y + PAD - 12;
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(WIDTH)}" height="${String(height)}" viewBox="0 0 ${String(WIDTH)} ${String(height)}" role="img" aria-label="Developer activity"><title>Developer activity</title>${parts.join("")}</svg>`;
+  const background = rect(0, 0, WIDTH, height, palette.background);
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${String(WIDTH)}" height="${String(height)}" viewBox="0 0 ${String(WIDTH)} ${String(height)}" role="img" aria-label="Developer activity"><title>Developer activity</title>${background}${parts.join("")}</svg>`;
 }
 
 // src/cv.ts
@@ -11587,6 +11606,161 @@ function deriveCv(localized) {
   };
 }
 
+// src/mcp.ts
+var MCP_PROFILE_SECTIONS = [
+  "profile",
+  "links",
+  "careers",
+  "projects",
+  "skills",
+  "certifications",
+  "memberships",
+  "volunteering",
+  "honors",
+  "education",
+  "publications",
+  "languages",
+  "courses",
+  "patents",
+  "testScores",
+  "recommendations",
+  "contact"
+];
+var McpRequestError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "McpRequestError";
+  }
+};
+var LANG_PROPERTY = {
+  type: "string",
+  description: 'BCP-47 locale tag (e.g. "ja", "en"). Resolves to the requested locale, falling back to the profile default when omitted or unavailable.'
+};
+var MCP_TOOLS = [
+  {
+    name: "get_profile",
+    title: "Get profile",
+    description: "Return the owner's full public profile, resolved to one locale and privacy-filtered (identical to the public `GET /api/profile`).",
+    inputSchema: {
+      type: "object",
+      properties: { lang: LANG_PROPERTY },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "get_section",
+    title: "Get profile section",
+    description: "Return a single section of the public profile (e.g. careers, education, skills), resolved to one locale and privacy-filtered.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        section: {
+          type: "string",
+          enum: [...MCP_PROFILE_SECTIONS],
+          description: "Which profile section to return."
+        },
+        lang: LANG_PROPERTY
+      },
+      required: ["section"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "get_jsonld",
+    title: "Get JSON-LD",
+    description: "Return the Schema.org JSON-LD (a `ProfilePage` wrapping a `Person`) for the profile, resolved to one locale (identical to `GET /api/jsonld`).",
+    inputSchema: {
+      type: "object",
+      properties: { lang: LANG_PROPERTY },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "list_locales",
+    title: "List locales",
+    description: "List the locales this profile is available in, plus the default \u2014 useful before calling another tool with a `lang` argument.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  }
+];
+var MCP_RESOURCES = [
+  {
+    uri: "takuhon://profile",
+    name: "profile",
+    title: "Canonical profile (takuhon.json)",
+    description: "The full canonical takuhon.json, privacy-filtered, with every locale retained (identical to `GET /takuhon.json`).",
+    mimeType: "application/json"
+  },
+  {
+    uri: "takuhon://schema",
+    name: "schema",
+    title: "Takuhon JSON Schema",
+    description: "The public JSON Schema contract the profile conforms to (identical to `GET /api/schema`). Lets an agent understand the document shape.",
+    mimeType: "application/json"
+  }
+];
+function executeMcpTool(name, args, profile) {
+  switch (name) {
+    case "get_profile": {
+      const localized = publicView(profile, readLang(args));
+      return { data: localized, resolvedLocale: localized.resolvedLocale };
+    }
+    case "get_section": {
+      const section = readSection(args);
+      const localized = publicView(profile, readLang(args));
+      return { data: localized[section], resolvedLocale: localized.resolvedLocale };
+    }
+    case "get_jsonld": {
+      const localized = publicView(profile, readLang(args));
+      return { data: generateJsonLd(localized), resolvedLocale: localized.resolvedLocale };
+    }
+    case "list_locales":
+      return {
+        data: {
+          defaultLocale: profile.settings.defaultLocale,
+          availableLocales: profile.settings.availableLocales,
+          ...profile.settings.fallbackLocale !== void 0 ? { fallbackLocale: profile.settings.fallbackLocale } : {}
+        }
+      };
+    default:
+      throw new McpRequestError(`Unknown MCP tool: ${name}`);
+  }
+}
+function readMcpResource(uri, profile) {
+  switch (uri) {
+    case "takuhon://profile":
+      return {
+        uri,
+        mimeType: "application/json",
+        data: applyPublicPrivacyFilter(profile)
+      };
+    case "takuhon://schema":
+      return { uri, mimeType: "application/json", data: schema };
+    default:
+      throw new McpRequestError(`Unknown MCP resource: ${uri}`);
+  }
+}
+function publicView(profile, lang) {
+  return applyPublicPrivacyFilter(resolveLocale(normalize(profile), lang));
+}
+function readLang(args) {
+  const lang = args.lang;
+  if (lang === void 0) return void 0;
+  if (typeof lang !== "string") {
+    throw new McpRequestError("`lang` must be a string (a BCP-47 locale tag).");
+  }
+  return lang;
+}
+function readSection(args) {
+  const section = args.section;
+  if (typeof section !== "string" || !isProfileSection(section)) {
+    throw new McpRequestError(`\`section\` must be one of: ${MCP_PROFILE_SECTIONS.join(", ")}.`);
+  }
+  return section;
+}
+function isProfileSection(value) {
+  return MCP_PROFILE_SECTIONS.includes(value);
+}
+
 // src/image.ts
 var ACCEPTED_IMAGE_MIME_TYPES = [
   "image/jpeg",
@@ -11922,11 +12096,17 @@ var SCHEMA_VERSION = "0.5.0";
 export {
   ACCEPTED_IMAGE_MIME_TYPES,
   ConflictError,
+  DARK_PALETTE,
   IMAGE_EXTENSIONS,
   ImportError,
+  LIGHT_PALETTE,
   MAX_IMAGE_BYTES,
   MAX_IMAGE_DIMENSION,
   MAX_IMAGE_FRAMES,
+  MCP_PROFILE_SECTIONS,
+  MCP_RESOURCES,
+  MCP_TOOLS,
+  McpRequestError,
   MigrationError,
   NotFoundError,
   RANK_FULL_CODING_HOURS,
@@ -11940,6 +12120,7 @@ export {
   deriveCv,
   deriveRankTier,
   detectImageMime,
+  executeMcpTool,
   exportTakuhon,
   formatCodingTime,
   generateJsonLd,
@@ -11951,6 +12132,7 @@ export {
   migrations,
   normalize,
   readImageInfo,
+  readMcpResource,
   renderActivitySvg,
   resolveLocale,
   schema,