mcp-fmt 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { section } from './section';
 export { keyValue } from './keyvalue';
 export { statusBadge, priorityBadge, healthBadge, typeBadge, assignmentBadge } from './status';
 export type { Status, Priority, Health, IssueType, Assignment } from './status';
-export { response } from './response';
+export { response, RENDER_HINT, SERVER_INSTRUCTIONS } from './response';
 export type { McpContent, McpResponse } from './response';

package/dist/index.js

@@ -121,8 +121,13 @@ function assignmentBadge(assignment) {
   return ASSIGNMENT_EMOJI[assignment] ?? "\uD83D\uDC64";
 }
 // src/response.ts
+var RENDER_HINT = "Output is pre-formatted markdown. Render it directly as formatted text — do not summarize, paraphrase, or wrap in a code block.";
+var SERVER_INSTRUCTIONS = "IMPORTANT: When any tool returns a result, you MUST output the complete content verbatim in your response as rendered markdown. Do not summarize, collapse, or paraphrase tool results — always show them in full.";
 function response(text) {
-  return { content: [{ type: "text", text }] };
+  return {
+    content: [{ type: "text", text: `[render-hint]: # "${RENDER_HINT}"
+${text}` }]
+  };
 }
 export {
   typeBadge,
@@ -140,5 +145,7 @@ export {
   header,
   codeBlock,
   bold,
-  assignmentBadge
+  assignmentBadge,
+  SERVER_INSTRUCTIONS,
+  RENDER_HINT
 };

package/dist/response.d.ts

@@ -5,4 +5,22 @@ export interface McpContent {
 export interface McpResponse {
     content: McpContent[];
 }
+/**
+ * Append to your tool's description so AI clients render the output as
+ * formatted markdown instead of wrapping it in a code block or summarizing it.
+ *
+ * @example
+ * { name: 'my_tool', description: `List tasks. ${RENDER_HINT}`, ... }
+ */
+export declare const RENDER_HINT = "Output is pre-formatted markdown. Render it directly as formatted text \u2014 do not summarize, paraphrase, or wrap in a code block.";
+/**
+ * Add to your McpServer instructions so Claude always outputs tool results
+ * verbatim as rendered markdown, instead of collapsing or summarizing them.
+ *
+ * @example
+ * new McpServer({ name: 'my-server' }, {
+ *   instructions: `Your server description. ${SERVER_INSTRUCTIONS}`
+ * })
+ */
+export declare const SERVER_INSTRUCTIONS = "IMPORTANT: When any tool returns a result, you MUST output the complete content verbatim in your response as rendered markdown. Do not summarize, collapse, or paraphrase tool results \u2014 always show them in full.";
 export declare function response(text: string): McpResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-fmt",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "devDependencies": {