@gethmy/mcp 2.6.0 → 2.7.0

package/dist/cli.js

@@ -69,6 +69,34 @@ function formatLabels(labels) {
   return `
 **Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
+function formatAttachments(attachments) {
+  if (!attachments || attachments.length === 0)
+    return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `
+## Attachments
+*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*
+${lines.join(`
+`)}`;
+}
+function formatExternalLinks(refs) {
+  if (!refs || refs.length === 0)
+    return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `
+## External References
+${lines.join(`
+`)}`;
+}
 function formatLinkedCards(links) {
   if (!links || links.length === 0)
     return "";
@@ -102,11 +130,15 @@ function generatePrompt(options) {
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions
   };
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
   const sections = [];
@@ -143,6 +175,12 @@ ${card.description}`);
   if (contextOpts.includeLinks && links.length > 0) {
     sections.push(formatLinkedCards(links));
   }
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
   sections.push(`
 ## Focus Areas`);
   roleFraming.focus.forEach((f) => {
@@ -1330,6 +1368,12 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
+  async archiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+  async unarchiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
   async getBoard(projectId, options) {
     const params = new URLSearchParams;
     if (options?.limit !== undefined)
@@ -1399,6 +1443,12 @@ class HarmonyApiClient {
   async getCardLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/links`);
   }
+  async getCardAttachments(cardId) {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+  async getCardExternalLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1710,6 +1760,30 @@ class HarmonyApiClient {
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map((att) => ({
+        id: att.id,
+        file_name: att.file_name,
+        file_type: att.file_type,
+        file_size: att.file_size,
+        signed_url: att.signed_url
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(options.cardId);
+      cardData.external_links = (externalLinksResult.external_links ?? []).map((link) => ({
+        id: link.id,
+        url: link.url,
+        title: link.title
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
     let columnData = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
     if (projectIdForBoard) {
@@ -2501,6 +2575,26 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_archive_project: {
+    description: "Archive a project. Hides the project (and all its columns and cards) from the active workspace. Can be restored later with harmony_unarchive_project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to archive" }
+      },
+      required: ["projectId"]
+    }
+  },
+  harmony_unarchive_project: {
+    description: "Restore an archived project so it (and its content) becomes visible again.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to unarchive" }
+      },
+      required: ["projectId"]
+    }
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -2689,6 +2783,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_get_card_attachments: {
+    description: "Get all file attachments for a card with short-lived signed URLs. URLs expire after `signed_url_expires_in` seconds (default 3600). Re-fetch to refresh.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_get_card_external_links: {
+    description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_create_subtask: {
     description: "Create a subtask on a card",
     inputSchema: {
@@ -3827,6 +3947,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.unarchiveCard(cardId);
       return { success: true, ...result };
     }
+    case "harmony_archive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.archiveProject(projectId);
+      return { success: true, ...result };
+    }
+    case "harmony_unarchive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.unarchiveProject(projectId);
+      return { success: true, ...result };
+    }
     case "harmony_delete_card": {
       const cardId = z.string().uuid().parse(args.cardId);
       await client3.deleteCard(cardId);
@@ -3944,6 +4074,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardLinks(cardId);
       return result;
     }
+    case "harmony_get_card_attachments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardAttachments(cardId);
+      return result;
+    }
+    case "harmony_get_card_external_links": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardExternalLinks(cardId);
+      return result;
+    }
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);

package/dist/index.js

@@ -69,6 +69,34 @@ function formatLabels(labels) {
   return `
 **Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
+function formatAttachments(attachments) {
+  if (!attachments || attachments.length === 0)
+    return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `
+## Attachments
+*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*
+${lines.join(`
+`)}`;
+}
+function formatExternalLinks(refs) {
+  if (!refs || refs.length === 0)
+    return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `
+## External References
+${lines.join(`
+`)}`;
+}
 function formatLinkedCards(links) {
   if (!links || links.length === 0)
     return "";
@@ -102,11 +130,15 @@ function generatePrompt(options) {
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions
   };
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
   const sections = [];
@@ -143,6 +175,12 @@ ${card.description}`);
   if (contextOpts.includeLinks && links.length > 0) {
     sections.push(formatLinkedCards(links));
   }
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
   sections.push(`
 ## Focus Areas`);
   roleFraming.focus.forEach((f) => {
@@ -1326,6 +1364,12 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
+  async archiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+  async unarchiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
   async getBoard(projectId, options) {
     const params = new URLSearchParams;
     if (options?.limit !== undefined)
@@ -1395,6 +1439,12 @@ class HarmonyApiClient {
   async getCardLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/links`);
   }
+  async getCardAttachments(cardId) {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+  async getCardExternalLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1706,6 +1756,30 @@ class HarmonyApiClient {
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map((att) => ({
+        id: att.id,
+        file_name: att.file_name,
+        file_type: att.file_type,
+        file_size: att.file_size,
+        signed_url: att.signed_url
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(options.cardId);
+      cardData.external_links = (externalLinksResult.external_links ?? []).map((link) => ({
+        id: link.id,
+        url: link.url,
+        title: link.title
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
     let columnData = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
     if (projectIdForBoard) {
@@ -2497,6 +2571,26 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_archive_project: {
+    description: "Archive a project. Hides the project (and all its columns and cards) from the active workspace. Can be restored later with harmony_unarchive_project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to archive" }
+      },
+      required: ["projectId"]
+    }
+  },
+  harmony_unarchive_project: {
+    description: "Restore an archived project so it (and its content) becomes visible again.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to unarchive" }
+      },
+      required: ["projectId"]
+    }
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -2685,6 +2779,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_get_card_attachments: {
+    description: "Get all file attachments for a card with short-lived signed URLs. URLs expire after `signed_url_expires_in` seconds (default 3600). Re-fetch to refresh.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_get_card_external_links: {
+    description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID"
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_create_subtask: {
     description: "Create a subtask on a card",
     inputSchema: {
@@ -3823,6 +3943,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.unarchiveCard(cardId);
       return { success: true, ...result };
     }
+    case "harmony_archive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.archiveProject(projectId);
+      return { success: true, ...result };
+    }
+    case "harmony_unarchive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client3.unarchiveProject(projectId);
+      return { success: true, ...result };
+    }
     case "harmony_delete_card": {
       const cardId = z.string().uuid().parse(args.cardId);
       await client3.deleteCard(cardId);
@@ -3940,6 +4070,16 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardLinks(cardId);
       return result;
     }
+    case "harmony_get_card_attachments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardAttachments(cardId);
+      return result;
+    }
+    case "harmony_get_card_external_links": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client3.getCardExternalLinks(cardId);
+      return result;
+    }
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);
       const title = z.string().min(1).max(500).parse(args.title);

package/dist/lib/api-client.js

@@ -66,6 +66,34 @@ function formatLabels(labels) {
   return `
 **Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
+function formatAttachments(attachments) {
+  if (!attachments || attachments.length === 0)
+    return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `
+## Attachments
+*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*
+${lines.join(`
+`)}`;
+}
+function formatExternalLinks(refs) {
+  if (!refs || refs.length === 0)
+    return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `
+## External References
+${lines.join(`
+`)}`;
+}
 function formatLinkedCards(links) {
   if (!links || links.length === 0)
     return "";
@@ -99,11 +127,15 @@ function generatePrompt(options) {
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions
   };
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
   const sections = [];
@@ -140,6 +172,12 @@ ${card.description}`);
   if (contextOpts.includeLinks && links.length > 0) {
     sections.push(formatLinkedCards(links));
   }
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
   sections.push(`
 ## Focus Areas`);
   roleFraming.focus.forEach((f) => {
@@ -933,6 +971,12 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
+  async archiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+  async unarchiveProject(projectId) {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
   async getBoard(projectId, options) {
     const params = new URLSearchParams;
     if (options?.limit !== undefined)
@@ -1002,6 +1046,12 @@ class HarmonyApiClient {
   async getCardLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/links`);
   }
+  async getCardAttachments(cardId) {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+  async getCardExternalLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -1313,6 +1363,30 @@ class HarmonyApiClient {
       const msg = err instanceof Error ? err.message : String(err);
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map((att) => ({
+        id: att.id,
+        file_name: att.file_name,
+        file_type: att.file_type,
+        file_size: att.file_size,
+        signed_url: att.signed_url
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(options.cardId);
+      cardData.external_links = (externalLinksResult.external_links ?? []).map((link) => ({
+        id: link.id,
+        url: link.url,
+        title: link.title
+      }));
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
     let columnData = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
     if (projectIdForBoard) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "publishConfig": {
     "access": "public"

package/src/api-client.ts

@@ -124,6 +124,28 @@ export class HarmonyUnauthorizedError extends Error {
   }
 }
 
+export interface CardAttachment {
+  id: string;
+  card_id: string;
+  file_name: string;
+  file_type: string;
+  file_size: number;
+  storage_path: string;
+  uploaded_by: string | null;
+  created_at: string;
+  signed_url: string | null;
+  signed_url_expires_in: number;
+}
+
+export interface CardExternalLinkRow {
+  id: string;
+  card_id: string;
+  url: string;
+  title: string | null;
+  created_by: string | null;
+  created_at: string;
+}
+
 export class HarmonyApiClient {
   private apiKey: string;
   private apiUrl: string;
@@ -376,6 +398,14 @@ export class HarmonyApiClient {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
 
+  async archiveProject(projectId: string): Promise<{ project: unknown }> {
+    return this.request("POST", `/projects/${projectId}/archive`);
+  }
+
+  async unarchiveProject(projectId: string): Promise<{ project: unknown }> {
+    return this.request("POST", `/projects/${projectId}/unarchive`);
+  }
+
   async getBoard(
     projectId: string,
     options?: {
@@ -524,6 +554,18 @@ export class HarmonyApiClient {
     return this.request("GET", `/cards/${cardId}/links`);
   }
 
+  async getCardAttachments(
+    cardId: string,
+  ): Promise<{ attachments: CardAttachment[] }> {
+    return this.request("GET", `/cards/${cardId}/attachments`);
+  }
+
+  async getCardExternalLinks(
+    cardId: string,
+  ): Promise<{ external_links: CardExternalLinkRow[] }> {
+    return this.request("GET", `/cards/${cardId}/external-links`);
+  }
+
   // ============ COLUMN OPERATIONS ============
 
   async createColumn(
@@ -1282,6 +1324,40 @@ export class HarmonyApiClient {
       console.debug(`[generateCardPrompt] getCardLinks failed: ${msg}`);
     }
 
+    // Fetch attachments + external links. Best-effort — never break prompt
+    // generation if storage signing or the underlying tables fail.
+    try {
+      const attachmentsResult = await this.getCardAttachments(options.cardId);
+      cardData.attachments = (attachmentsResult.attachments ?? []).map(
+        (att) => ({
+          id: att.id,
+          file_name: att.file_name,
+          file_type: att.file_type,
+          file_size: att.file_size,
+          signed_url: att.signed_url,
+        }),
+      );
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardAttachments failed: ${msg}`);
+    }
+
+    try {
+      const externalLinksResult = await this.getCardExternalLinks(
+        options.cardId,
+      );
+      cardData.external_links = (externalLinksResult.external_links ?? []).map(
+        (link) => ({
+          id: link.id,
+          url: link.url,
+          title: link.title,
+        }),
+      );
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] getCardExternalLinks failed: ${msg}`);
+    }
+
     // Try to get column info
     let columnData: { name: string } | null = null;
     const projectIdForBoard = options.projectId || cardData.project_id;
@@ -1395,6 +1471,18 @@ interface CardPromptData {
     direction: "outgoing" | "incoming";
   }>;
   assignee?: { full_name?: string; email: string } | null;
+  attachments?: Array<{
+    id: string;
+    file_name: string;
+    file_type: string;
+    file_size: number;
+    signed_url: string | null;
+  }>;
+  external_links?: Array<{
+    id: string;
+    url: string;
+    title?: string | null;
+  }>;
   column_id?: string;
   project_id?: string;
 }

package/src/prompt-builder.ts

@@ -44,6 +44,8 @@ export interface PromptContextOptions {
   includePriority: boolean;
   includeLinks: boolean;
   includeColumn: boolean;
+  includeAttachments: boolean;
+  includeExternalLinks: boolean;
 }
 
 export interface RoleFraming {
@@ -307,6 +309,27 @@ function formatLabels(labels: Array<{ name: string }>): string {
   return `\n**Labels:** ${labels.map((l) => l.name).join(", ")}`;
 }
 
+function formatAttachments(attachments: CardAttachmentRef[]): string {
+  if (!attachments || attachments.length === 0) return "";
+  const lines = attachments.map((att) => {
+    const isImage = att.file_type.startsWith("image/");
+    const sizeKb = Math.max(1, Math.round(att.file_size / 1024));
+    const url = att.signed_url ?? "(signed URL unavailable)";
+    const kind = isImage ? "image" : att.file_type;
+    return `  - ${att.file_name} (${kind}, ${sizeKb} KB) — ${url}`;
+  });
+  return `\n## Attachments\n*Signed URLs expire in ~1 hour. Re-fetch via \`harmony_get_card_attachments\` if expired.*\n${lines.join("\n")}`;
+}
+
+function formatExternalLinks(refs: CardExternalLinkRef[]): string {
+  if (!refs || refs.length === 0) return "";
+  const lines = refs.map((ref) => {
+    const label = ref.title?.trim() || ref.url;
+    return `  - ${label} — ${ref.url}`;
+  });
+  return `\n## External References\n${lines.join("\n")}`;
+}
+
 /**
  * Format linked cards for prompt
  */
@@ -325,6 +348,20 @@ function formatLinkedCards(
   return `\n## Related Cards\n${lines.join("\n")}`;
 }
 
+export interface CardAttachmentRef {
+  id: string;
+  file_name: string;
+  file_type: string;
+  file_size: number;
+  signed_url: string | null;
+}
+
+export interface CardExternalLinkRef {
+  id: string;
+  url: string;
+  title?: string | null;
+}
+
 export interface CardData {
   id: string;
   short_id: number;
@@ -341,6 +378,8 @@ export interface CardData {
     direction: "outgoing" | "incoming";
   }>;
   assignee?: { full_name?: string; email: string } | null;
+  attachments?: CardAttachmentRef[];
+  external_links?: CardExternalLinkRef[];
 }
 
 export interface ColumnData {
@@ -397,12 +436,16 @@ export function generatePrompt(
     includePriority: true,
     includeLinks: true,
     includeColumn: true,
+    includeAttachments: true,
+    includeExternalLinks: true,
     ...options.contextOptions,
   };
 
   const labels = card.labels || [];
   const subtasks = card.subtasks || [];
   const links = card.links || [];
+  const attachments = card.attachments || [];
+  const externalLinks = card.external_links || [];
 
   const category = inferCategoryFromLabels(labels);
   const roleFraming = getRoleFraming(category);
@@ -456,6 +499,16 @@ export function generatePrompt(
     sections.push(formatLinkedCards(links));
   }
 
+  // Attachments (signed URLs) — fetchable image/file references
+  if (contextOpts.includeAttachments && attachments.length > 0) {
+    sections.push(formatAttachments(attachments));
+  }
+
+  // External URL references (docs, gists, dashboards)
+  if (contextOpts.includeExternalLinks && externalLinks.length > 0) {
+    sections.push(formatExternalLinks(externalLinks));
+  }
+
   // Focus areas
   sections.push(`\n## Focus Areas`);
   roleFraming.focus.forEach((f) => {

package/src/server.ts

@@ -348,6 +348,28 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_archive_project: {
+    description:
+      "Archive a project. Hides the project (and all its columns and cards) from the active workspace. Can be restored later with harmony_unarchive_project.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to archive" },
+      },
+      required: ["projectId"],
+    },
+  },
+  harmony_unarchive_project: {
+    description:
+      "Restore an archived project so it (and its content) becomes visible again.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID to unarchive" },
+      },
+      required: ["projectId"],
+    },
+  },
   harmony_delete_card: {
     description: "Delete a card",
     inputSchema: {
@@ -546,6 +568,34 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_get_card_attachments: {
+    description:
+      "Get all file attachments for a card with short-lived signed URLs. URLs expire after `signed_url_expires_in` seconds (default 3600). Re-fetch to refresh.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID",
+        },
+      },
+      required: ["cardId"],
+    },
+  },
+  harmony_get_card_external_links: {
+    description:
+      "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: {
+          type: "string",
+          description: "Card UUID",
+        },
+      },
+      required: ["cardId"],
+    },
+  },
 
   // Subtask operations
   harmony_create_subtask: {
@@ -1908,6 +1958,18 @@ async function handleToolCall(
       return { success: true, ...result };
     }
 
+    case "harmony_archive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client.archiveProject(projectId);
+      return { success: true, ...result };
+    }
+
+    case "harmony_unarchive_project": {
+      const projectId = z.string().uuid().parse(args.projectId);
+      const result = await client.unarchiveProject(projectId);
+      return { success: true, ...result };
+    }
+
     case "harmony_delete_card": {
       const cardId = z.string().uuid().parse(args.cardId);
       await client.deleteCard(cardId);
@@ -2074,6 +2136,18 @@ async function handleToolCall(
       return result;
     }
 
+    case "harmony_get_card_attachments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client.getCardAttachments(cardId);
+      return result;
+    }
+
+    case "harmony_get_card_external_links": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const result = await client.getCardExternalLinks(cardId);
+      return result;
+    }
+
     // Subtask operations
     case "harmony_create_subtask": {
       const cardId = z.string().uuid().parse(args.cardId);