fastmcp 1.27.6 → 2.0.0

package/src/FastMCP.test.ts

@@ -17,6 +17,7 @@ import { expect, test, vi } from "vitest";
 import { z } from "zod";
 
 import {
+  audioContent,
   type ContentResult,
   FastMCP,
   FastMCPSession,
@@ -51,11 +52,10 @@ const runWithTestServer = async ({
       });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   try {
@@ -269,6 +269,55 @@ test("returns an image", async () => {
   });
 });
 
+test("returns an audio", async () => {
+  await runWithTestServer({
+    run: async ({ client }) => {
+      expect(
+        await client.callTool({
+          arguments: {
+            a: 1,
+            b: 2,
+          },
+          name: "add",
+        }),
+      ).toEqual({
+        content: [
+          {
+            data: "UklGRhwMAABXQVZFZm10IBAAAAABAAEAgD4AAIA+AAABAAgAZGF0Ya4LAACAgICAgICAgICAgICAgICAgICAgICAgICAf3hxeH+AfXZ1eHx6dnR5fYGFgoOKi42aloubq6GOjI2Op7ythXJ0eYF5aV1AOFFib32HmZSHhpCalIiYi4SRkZaLfnhxaWptb21qaWBea2BRYmZTVmFgWFNXVVVhaGdbYGhZbXh1gXZ1goeIlot1k6yxtKaOkaWhq7KonKCZoaCjoKWuqqmurK6ztrO7tbTAvru/vb68vbW6vLGqsLOfm5yal5KKhoyBeHt2dXBnbmljVlJWUEBBPDw9Mi4zKRwhIBYaGRQcHBURGB0XFxwhGxocJSstMjg6PTc6PUxVV1lWV2JqaXN0coCHhIyPjpOenqWppK6xu72yxMu9us7Pw83Wy9nY29ve6OPr6uvs6ezu6ejk6erm3uPj3dbT1sjBzdDFuMHAt7m1r7W6qaCupJOTkpWPgHqAd3JrbGlnY1peX1hTUk9PTFRKR0RFQkRBRUVEQkdBPjs9Pzo6NT04Njs+PTxAPzo/Ojk6PEA5PUJAQD04PkRCREZLUk1KT1BRUVdXU1VRV1tZV1xgXltcXF9hXl9eY2VmZmlna3J0b3F3eHyBfX+JgIWJiouTlZCTmpybnqSgnqyrqrO3srK2uL2/u7jAwMLFxsfEv8XLzcrIy83JzcrP0s3M0dTP0drY1dPR1dzc19za19XX2dnU1NjU0dXPzdHQy8rMysfGxMLBvLu3ta+sraeioJ2YlI+MioeFfX55cnJsaWVjXVlbVE5RTktHRUVAPDw3NC8uLyknKSIiJiUdHiEeGx4eHRwZHB8cHiAfHh8eHSEhISMoJyMnKisrLCszNy8yOTg9QEJFRUVITVFOTlJVWltaXmNfX2ZqZ21xb3R3eHqAhoeJkZKTlZmhpJ6kqKeur6yxtLW1trW4t6+us7axrbK2tLa6ury7u7u9u7vCwb+/vr7Ev7y9v8G8vby6vru4uLq+tri8ubi5t7W4uLW5uLKxs7G0tLGwt7Wvs7avr7O0tLW4trS4uLO1trW1trm1tLm0r7Kyr66wramsqaKlp52bmpeWl5KQkImEhIB8fXh3eHJrbW5mYGNcWFhUUE1LRENDQUI9ODcxLy8vMCsqLCgoKCgpKScoKCYoKygpKyssLi0sLi0uMDIwMTIuLzQ0Njg4Njc8ODlBQ0A/RUdGSU5RUVFUV1pdXWFjZGdpbG1vcXJ2eXh6fICAgIWIio2OkJGSlJWanJqbnZ2cn6Kkp6enq62srbCysrO1uLy4uL+/vL7CwMHAvb/Cvbq9vLm5uba2t7Sysq+urqyqqaalpqShoJ+enZuamZqXlZWTkpGSkpCNjpCMioqLioiHhoeGhYSGg4GDhoKDg4GBg4GBgoGBgoOChISChISChIWDg4WEgoSEgYODgYGCgYGAgICAgX99f398fX18e3p6e3t7enp7fHx4e3x6e3x7fHx9fX59fn1+fX19fH19fnx9fn19fX18fHx7fHx6fH18fXx8fHx7fH1+fXx+f319fn19fn1+gH9+f4B/fn+AgICAgH+AgICAgIGAgICAgH9+f4B+f35+fn58e3t8e3p5eXh4d3Z1dHRzcXBvb21sbmxqaWhlZmVjYmFfX2BfXV1cXFxaWVlaWVlYV1hYV1hYWVhZWFlaWllbXFpbXV5fX15fYWJhYmNiYWJhYWJjZGVmZ2hqbG1ub3Fxc3V3dnd6e3t8e3x+f3+AgICAgoGBgoKDhISFh4aHiYqKi4uMjYyOj4+QkZKUlZWXmJmbm52enqCioqSlpqeoqaqrrK2ur7CxsrGys7O0tbW2tba3t7i3uLe4t7a3t7i3tre2tba1tLSzsrKysbCvrq2sq6qop6alo6OioJ+dnJqZmJeWlJKSkI+OjoyLioiIh4WEg4GBgH9+fXt6eXh3d3V0c3JxcG9ubWxsamppaWhnZmVlZGRjYmNiYWBhYGBfYF9fXl5fXl1dXVxdXF1dXF1cXF1cXF1dXV5dXV5fXl9eX19gYGFgYWJhYmFiY2NiY2RjZGNkZWRlZGVmZmVmZmVmZ2dmZ2hnaGhnaGloZ2hpaWhpamlqaWpqa2pra2xtbGxtbm1ubm5vcG9wcXBxcnFycnN0c3N0dXV2d3d4eHh5ent6e3x9fn5/f4CAgIGCg4SEhYaGh4iIiYqLi4uMjY2Oj5CQkZGSk5OUlJWWlpeYl5iZmZqbm5ybnJ2cnZ6en56fn6ChoKChoqGio6KjpKOko6SjpKWkpaSkpKSlpKWkpaSlpKSlpKOkpKOko6KioaKhoaCfoJ+enp2dnJybmpmZmJeXlpWUk5STkZGQj4+OjYyLioqJh4eGhYSEgoKBgIB/fn59fHt7enl5eHd3dnZ1dHRzc3JycXBxcG9vbm5tbWxrbGxraWppaWhpaGdnZ2dmZ2ZlZmVmZWRlZGVkY2RjZGNkZGRkZGRkZGRkZGRjZGRkY2RjZGNkZWRlZGVmZWZmZ2ZnZ2doaWhpaWpra2xsbW5tbm9ub29wcXFycnNzdHV1dXZ2d3d4eXl6enp7fHx9fX5+f4CAgIGAgYGCgoOEhISFhoWGhoeIh4iJiImKiYqLiouLjI2MjI2OjY6Pj46PkI+QkZCRkJGQkZGSkZKRkpGSkZGRkZKRkpKRkpGSkZKRkpGSkZKRkpGSkZCRkZCRkI+Qj5CPkI+Pjo+OjY6Njo2MjYyLjIuMi4qLioqJiomJiImIh4iHh4aHhoaFhoWFhIWEg4SDg4KDgoKBgoGAgYCBgICAgICAf4CAf39+f35/fn1+fX59fHx9fH18e3x7fHt6e3p7ent6e3p5enl6enl6eXp5eXl4eXh5eHl4eXh5eHl4eXh5eHh3eHh4d3h4d3h3d3h4d3l4eHd4d3h3eHd4d3h3eHh4eXh5eHl4eHl4eXh5enl6eXp5enl6eXp5ent6ent6e3x7fHx9fH18fX19fn1+fX5/fn9+f4B/gH+Af4CAgICAgIGAgYCBgoGCgYKCgoKDgoOEg4OEg4SFhIWEhYSFhoWGhYaHhoeHhoeGh4iHiIiHiImIiImKiYqJiYqJiouKi4qLiouKi4qLiouKi4qLiouKi4qLi4qLiouKi4qLiomJiomIiYiJiImIh4iIh4iHhoeGhYWGhYaFhIWEg4OEg4KDgoOCgYKBgIGAgICAgH+Af39+f359fn18fX19fHx8e3t6e3p7enl6eXp5enl6enl5eXh5eHh5eHl4eXh5eHl4eHd5eHd3eHl4d3h3eHd4d3h3eHh4d3h4d3h3d3h5eHl4eXh5eHl5eXp5enl6eXp7ent6e3p7e3t7fHt8e3x8fHx9fH1+fX59fn9+f35/gH+AgICAgICAgYGAgYKBgoGCgoKDgoOEg4SEhIWFhIWFhoWGhYaGhoaHhoeGh4aHhoeIh4iHiIeHiIeIh4iHiIeIiIiHiIeIh4iHiIiHiIeIh4iHiIeIh4eIh4eIh4aHh4aHhoeGh4aHhoWGhYaFhoWFhIWEhYSFhIWEhISDhIOEg4OCg4OCg4KDgYKCgYKCgYCBgIGAgYCBgICAgICAgICAf4B/f4B/gH+Af35/fn9+f35/fn1+fn19fn1+fX59fn19fX19fH18fXx9fH18fXx9fH18fXx8fHt8e3x7fHt8e3x7fHt8e3x7fHt8e3x7fHt8e3x7fHt8e3x8e3x7fHt8e3x7fHx8fXx9fH18fX5+fX59fn9+f35+f35/gH+Af4B/gICAgICAgICAgICAgYCBgIGAgIGAgYGBgoGCgYKBgoGCgYKBgoGCgoKDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KCgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGBgYCBgIGAgYCBgIGAgYCBgIGAgYCBgIGAgYCBgIGAgYCAgICBgIGAgYCBgIGAgYCBgIGAgYCBgExJU1RCAAAASU5GT0lDUkQMAAAAMjAwOC0wOS0yMQAASUVORwMAAAAgAAABSVNGVBYAAABTb255IFNvdW5kIEZvcmdlIDguMAAA",
+            mimeType: "audio/wav",
+            type: "audio",
+          },
+        ],
+      });
+    },
+    server: async () => {
+      const server = new FastMCP({
+        name: "Test",
+        version: "1.0.0",
+      });
+
+      server.addTool({
+        description: "Add two numbers",
+        execute: async () => {
+          return audioContent({
+            buffer: Buffer.from(
+              "UklGRhwMAABXQVZFZm10IBAAAAABAAEAgD4AAIA+AAABAAgAZGF0Ya4LAACAgICAgICAgICAgICAgICAgICAgICAgICAf3hxeH+AfXZ1eHx6dnR5fYGFgoOKi42aloubq6GOjI2Op7ythXJ0eYF5aV1AOFFib32HmZSHhpCalIiYi4SRkZaLfnhxaWptb21qaWBea2BRYmZTVmFgWFNXVVVhaGdbYGhZbXh1gXZ1goeIlot1k6yxtKaOkaWhq7KonKCZoaCjoKWuqqmurK6ztrO7tbTAvru/vb68vbW6vLGqsLOfm5yal5KKhoyBeHt2dXBnbmljVlJWUEBBPDw9Mi4zKRwhIBYaGRQcHBURGB0XFxwhGxocJSstMjg6PTc6PUxVV1lWV2JqaXN0coCHhIyPjpOenqWppK6xu72yxMu9us7Pw83Wy9nY29ve6OPr6uvs6ezu6ejk6erm3uPj3dbT1sjBzdDFuMHAt7m1r7W6qaCupJOTkpWPgHqAd3JrbGlnY1peX1hTUk9PTFRKR0RFQkRBRUVEQkdBPjs9Pzo6NT04Njs+PTxAPzo/Ojk6PEA5PUJAQD04PkRCREZLUk1KT1BRUVdXU1VRV1tZV1xgXltcXF9hXl9eY2VmZmlna3J0b3F3eHyBfX+JgIWJiouTlZCTmpybnqSgnqyrqrO3srK2uL2/u7jAwMLFxsfEv8XLzcrIy83JzcrP0s3M0dTP0drY1dPR1dzc19za19XX2dnU1NjU0dXPzdHQy8rMysfGxMLBvLu3ta+sraeioJ2YlI+MioeFfX55cnJsaWVjXVlbVE5RTktHRUVAPDw3NC8uLyknKSIiJiUdHiEeGx4eHRwZHB8cHiAfHh8eHSEhISMoJyMnKisrLCszNy8yOTg9QEJFRUVITVFOTlJVWltaXmNfX2ZqZ21xb3R3eHqAhoeJkZKTlZmhpJ6kqKeur6yxtLW1trW4t6+us7axrbK2tLa6ury7u7u9u7vCwb+/vr7Ev7y9v8G8vby6vru4uLq+tri8ubi5t7W4uLW5uLKxs7G0tLGwt7Wvs7avr7O0tLW4trS4uLO1trW1trm1tLm0r7Kyr66wramsqaKlp52bmpeWl5KQkImEhIB8fXh3eHJrbW5mYGNcWFhUUE1LRENDQUI9ODcxLy8vMCsqLCgoKCgpKScoKCYoKygpKyssLi0sLi0uMDIwMTIuLzQ0Njg4Njc8ODlBQ0A/RUdGSU5RUVFUV1pdXWFjZGdpbG1vcXJ2eXh6fICAgIWIio2OkJGSlJWanJqbnZ2cn6Kkp6enq62srbCysrO1uLy4uL+/vL7CwMHAvb/Cvbq9vLm5uba2t7Sysq+urqyqqaalpqShoJ+enZuamZqXlZWTkpGSkpCNjpCMioqLioiHhoeGhYSGg4GDhoKDg4GBg4GBgoGBgoOChISChISChIWDg4WEgoSEgYODgYGCgYGAgICAgX99f398fX18e3p6e3t7enp7fHx4e3x6e3x7fHx9fX59fn1+fX19fH19fnx9fn19fX18fHx7fHx6fH18fXx8fHx7fH1+fXx+f319fn19fn1+gH9+f4B/fn+AgICAgH+AgICAgIGAgICAgH9+f4B+f35+fn58e3t8e3p5eXh4d3Z1dHRzcXBvb21sbmxqaWhlZmVjYmFfX2BfXV1cXFxaWVlaWVlYV1hYV1hYWVhZWFlaWllbXFpbXV5fX15fYWJhYmNiYWJhYWJjZGVmZ2hqbG1ub3Fxc3V3dnd6e3t8e3x+f3+AgICAgoGBgoKDhISFh4aHiYqKi4uMjYyOj4+QkZKUlZWXmJmbm52enqCioqSlpqeoqaqrrK2ur7CxsrGys7O0tbW2tba3t7i3uLe4t7a3t7i3tre2tba1tLSzsrKysbCvrq2sq6qop6alo6OioJ+dnJqZmJeWlJKSkI+OjoyLioiIh4WEg4GBgH9+fXt6eXh3d3V0c3JxcG9ubWxsamppaWhnZmVlZGRjYmNiYWBhYGBfYF9fXl5fXl1dXVxdXF1dXF1cXF1cXF1dXV5dXV5fXl9eX19gYGFgYWJhYmFiY2NiY2RjZGNkZWRlZGVmZmVmZmVmZ2dmZ2hnaGhnaGloZ2hpaWhpamlqaWpqa2pra2xtbGxtbm1ubm5vcG9wcXBxcnFycnN0c3N0dXV2d3d4eHh5ent6e3x9fn5/f4CAgIGCg4SEhYaGh4iIiYqLi4uMjY2Oj5CQkZGSk5OUlJWWlpeYl5iZmZqbm5ybnJ2cnZ6en56fn6ChoKChoqGio6KjpKOko6SjpKWkpaSkpKSlpKWkpaSlpKSlpKOkpKOko6KioaKhoaCfoJ+enp2dnJybmpmZmJeXlpWUk5STkZGQj4+OjYyLioqJh4eGhYSEgoKBgIB/fn59fHt7enl5eHd3dnZ1dHRzc3JycXBxcG9vbm5tbWxrbGxraWppaWhpaGdnZ2dmZ2ZlZmVmZWRlZGVkY2RjZGNkZGRkZGRkZGRkZGRjZGRkY2RjZGNkZWRlZGVmZWZmZ2ZnZ2doaWhpaWpra2xsbW5tbm9ub29wcXFycnNzdHV1dXZ2d3d4eXl6enp7fHx9fX5+f4CAgIGAgYGCgoOEhISFhoWGhoeIh4iJiImKiYqLiouLjI2MjI2OjY6Pj46PkI+QkZCRkJGQkZGSkZKRkpGSkZGRkZKRkpKRkpGSkZKRkpGSkZKRkpGSkZCRkZCRkI+Qj5CPkI+Pjo+OjY6Njo2MjYyLjIuMi4qLioqJiomJiImIh4iHh4aHhoaFhoWFhIWEg4SDg4KDgoKBgoGAgYCBgICAgICAf4CAf39+f35/fn1+fX59fHx9fH18e3x7fHt6e3p7ent6e3p5enl6enl6eXp5eXl4eXh5eHl4eXh5eHl4eXh5eHh3eHh4d3h4d3h3d3h4d3l4eHd4d3h3eHd4d3h3eHh4eXh5eHl4eHl4eXh5enl6eXp5enl6eXp5ent6ent6e3x7fHx9fH18fX19fn1+fX5/fn9+f4B/gH+Af4CAgICAgIGAgYCBgoGCgYKCgoKDgoOEg4OEg4SFhIWEhYSFhoWGhYaHhoeHhoeGh4iHiIiHiImIiImKiYqJiYqJiouKi4qLiouKi4qLiouKi4qLiouKi4qLi4qLiouKi4qLiomJiomIiYiJiImIh4iIh4iHhoeGhYWGhYaFhIWEg4OEg4KDgoOCgYKBgIGAgICAgH+Af39+f359fn18fX19fHx8e3t6e3p7enl6eXp5enl6enl5eXh5eHh5eHl4eXh5eHl4eHd5eHd3eHl4d3h3eHd4d3h3eHh4d3h4d3h3d3h5eHl4eXh5eHl5eXp5enl6eXp7ent6e3p7e3t7fHt8e3x8fHx9fH1+fX59fn9+f35/gH+AgICAgICAgYGAgYKBgoGCgoKDgoOEg4SEhIWFhIWFhoWGhYaGhoaHhoeGh4aHhoeIh4iHiIeHiIeIh4iHiIeIiIiHiIeIh4iHiIiHiIeIh4iHiIeIh4eIh4eIh4aHh4aHhoeGh4aHhoWGhYaFhoWFhIWEhYSFhIWEhISDhIOEg4OCg4OCg4KDgYKCgYKCgYCBgIGAgYCBgICAgICAgICAf4B/f4B/gH+Af35/fn9+f35/fn1+fn19fn1+fX59fn19fX19fH18fXx9fH18fXx9fH18fXx8fHt8e3x7fHt8e3x7fHt8e3x7fHt8e3x7fHt8e3x7fHt8e3x8e3x7fHt8e3x7fHx8fXx9fH18fX5+fX59fn9+f35+f35/gH+Af4B/gICAgICAgICAgICAgYCBgIGAgIGAgYGBgoGCgYKBgoGCgYKBgoGCgoKDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KDgoOCg4KCgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGCgYKBgoGBgYCBgIGAgYCBgIGAgYCBgIGAgYCBgIGAgYCBgIGAgYCAgICBgIGAgYCBgIGAgYCBgIGAgYCBgExJU1RCAAAASU5GT0lDUkQMAAAAMjAwOC0wOS0yMQAASUVORwMAAAAgAAABSVNGVBYAAABTb255IFNvdW5kIEZvcmdlIDguMAAA",
+              "base64",
+            ),
+          });
+        },
+        name: "add",
+        parameters: z.object({
+          a: z.number(),
+          b: z.number(),
+        }),
+      });
+
+      return server;
+    },
+  });
+});
+
 test("handles UserError errors", async () => {
   await runWithTestServer({
     run: async ({ client }) => {
@@ -742,11 +791,10 @@ test("uses events to notify server of client connect/disconnect", async () => {
   server.on("disconnect", onDisconnect);
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   const client = new Client(
@@ -791,11 +839,10 @@ test("handles multiple clients", async () => {
   });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   const client1 = new Client(
@@ -1472,11 +1519,10 @@ test("allows new clients to connect after a client disconnects", async () => {
   });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   const client1 = new Client(
@@ -1551,11 +1597,10 @@ test("able to close server immediately after starting it", async () => {
   });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   // We were previously not waiting for the server to start.
@@ -1584,11 +1629,10 @@ test("closing event source does not produce error", async () => {
   });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   const eventSource = await new Promise<EventSourceClient>((onMessage) => {
@@ -1647,11 +1691,10 @@ test("provides auth to tools", async () => {
   });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   const client = new Client(
@@ -1716,10 +1759,90 @@ test("provides auth to tools", async () => {
       },
       reportProgress: expect.any(Function),
       session: { id: 1 },
+      streamContent: expect.any(Function),
     },
   );
 });
 
+test("supports streaming output from tools", async () => {
+  let streamResult: { content: Array<{ text: string; type: string }> };
+
+  await runWithTestServer({
+    run: async ({ client }) => {
+      const result = await client.callTool({
+        arguments: {},
+        name: "streaming-void-tool",
+      });
+
+      expect(result).toEqual({
+        content: [],
+      });
+
+      streamResult = (await client.callTool({
+        arguments: {},
+        name: "streaming-with-result",
+      })) as { content: Array<{ text: string; type: string }> };
+
+      expect(streamResult).toEqual({
+        content: [{ text: "Final result after streaming", type: "text" }],
+      });
+    },
+    server: async () => {
+      const server = new FastMCP({
+        name: "Test",
+        version: "1.0.0",
+      });
+
+      server.addTool({
+        annotations: {
+          streamingHint: true,
+        },
+        description: "Tool yang streaming dan mengembalikan void",
+        execute: async (_args, context) => {
+          await context.streamContent({
+            text: "Streaming content 1",
+            type: "text",
+          });
+
+          await context.streamContent({
+            text: "Streaming content 2",
+            type: "text",
+          });
+
+          // Return void
+          return;
+        },
+        name: "streaming-void-tool",
+        parameters: z.object({}),
+      });
+
+      server.addTool({
+        annotations: {
+          streamingHint: true,
+        },
+        description: "Tool yang streaming dan mengembalikan hasil",
+        execute: async (_args, context) => {
+          await context.streamContent({
+            text: "Streaming content 1",
+            type: "text",
+          });
+
+          await context.streamContent({
+            text: "Streaming content 2",
+            type: "text",
+          });
+
+          return "Final result after streaming";
+        },
+        name: "streaming-with-result",
+        parameters: z.object({}),
+      });
+
+      return server;
+    },
+  });
+});
+
 test("blocks unauthorized requests", async () => {
   const port = await getRandomPort();
 
@@ -1735,11 +1858,10 @@ test("blocks unauthorized requests", async () => {
   });
 
   await server.start({
-    sse: {
-      endpoint: "/sse",
+    httpStream: {
       port,
     },
-    transportType: "sse",
+    transportType: "httpStream",
   });
 
   const client = new Client(
@@ -1767,6 +1889,7 @@ test("blocks unauthorized requests", async () => {
 // Set longer timeout for HTTP Stream tests
 test("HTTP Stream: calls a tool", { timeout: 20000 }, async () => {
   console.log("Starting HTTP Stream test...");
+
   const port = await getRandomPort();
 
   // Create server directly (don't use helper function)
@@ -1789,7 +1912,6 @@ test("HTTP Stream: calls a tool", { timeout: 20000 }, async () => {
 
   await server.start({
     httpStream: {
-      endpoint: "/httpStream",
       port,
     },
     transportType: "httpStream",
@@ -1810,7 +1932,7 @@ test("HTTP Stream: calls a tool", { timeout: 20000 }, async () => {
     // IMPORTANT: Don't provide sessionId manually with HTTP streaming
     // The server will generate a session ID automatically
     const transport = new StreamableHTTPClientTransport(
-      new URL(`http://localhost:${port}/httpStream`),
+      new URL(`http://localhost:${port}/stream`),
     );
 
     // Connect client to server
@@ -1835,6 +1957,7 @@ test("HTTP Stream: calls a tool", { timeout: 20000 }, async () => {
 
     // Clean up connection
     await transport.terminateSession();
+
     await client.close();
   } finally {
     await server.stop();

package/src/FastMCP.ts

@@ -2,7 +2,6 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import {
-  AudioContent,
   CallToolRequestSchema,
   ClientCapabilities,
   CompleteRequestSchema,
@@ -26,7 +25,7 @@ import { fileTypeFromBuffer } from "file-type";
 import { readFile } from "fs/promises";
 import Fuse from "fuse.js";
 import http from "http";
-import { startHTTPStreamServer, startSSEServer } from "mcp-proxy";
+import { startHTTPServer } from "mcp-proxy";
 import { StrictEventEmitter } from "strict-event-emitter-types";
 import { setTimeout as delay } from "timers/promises";
 import { fetch } from "undici";
@@ -181,6 +180,7 @@ type Context<T extends FastMCPSessionAuth> = {
   };
   reportProgress: (progress: Progress) => Promise<void>;
   session: T | undefined;
+  streamContent: (content: Content | Content[]) => Promise<void>;
 };
 
 type Extra = unknown;
@@ -264,11 +264,29 @@ const ImageContentZodSchema = z
   })
   .strict() satisfies z.ZodType<ImageContent>;
 
-type Content = ImageContent | TextContent;
+type AudioContent = {
+  data: string;
+  mimeType: string;
+  type: "audio";
+};
+
+const AudioContentZodSchema = z
+  .object({
+    /**
+     * The base64-encoded audio data.
+     */
+    data: z.string().base64(),
+    mimeType: z.string(),
+    type: z.literal("audio"),
+  })
+  .strict() satisfies z.ZodType<AudioContent>;
+
+type Content = AudioContent | ImageContent | TextContent;
 
 const ContentZodSchema = z.discriminatedUnion("type", [
   TextContentZodSchema,
   ImageContentZodSchema,
+  AudioContentZodSchema,
 ]) satisfies z.ZodType<Content>;
 
 type ContentResult = {
@@ -466,13 +484,19 @@ type Tool<
   T extends FastMCPSessionAuth,
   Params extends ToolParameters = ToolParameters,
 > = {
-  annotations?: ToolAnnotations;
+  annotations?: {
+    /**
+     * When true, the tool leverages incremental content streaming
+     * Return void for tools that handle all their output via streaming
+     */
+    streamingHint?: boolean;
+  } & ToolAnnotations;
   description?: string;
   execute: (
     args: StandardSchemaV1.InferOutput<Params>,
     context: Context<T>,
   ) => Promise<
-    AudioContent | ContentResult | ImageContent | string | TextContent
+    AudioContent | ContentResult | ImageContent | string | TextContent | void
   >;
   name: string;
   parameters?: Params;
@@ -750,7 +774,7 @@ export class FastMCPSession<
 
     if ("type" in transport) {
       // Enable by default for SSE and HTTP streaming
-      if (transport.type === "sse" || transport.type === "httpStream") {
+      if (transport.type === "httpStream") {
         defaultEnabled = true;
       }
     }
@@ -1249,14 +1273,29 @@ export class FastMCPSession<
         };
 
         // Create a promise for tool execution
+        // Streams partial results while a tool is still executing
+        // Enables progressive rendering and real-time feedback
+        const streamContent = async (content: Content | Content[]) => {
+          const contentArray = Array.isArray(content) ? content : [content];
+
+          await this.#server.notification({
+            method: "notifications/tool/streamContent",
+            params: {
+              content: contentArray,
+              toolName: request.params.name,
+            },
+          });
+        };
+
         const executeToolPromise = tool.execute(args, {
           log,
           reportProgress,
           session: this.#auth,
+          streamContent,
         });
 
         // Handle timeout if specified
-        const maybeStringResult = await (tool.timeoutMs
+        const maybeStringResult = (await (tool.timeoutMs
           ? Promise.race([
               executeToolPromise,
               new Promise<never>((_, reject) => {
@@ -1269,9 +1308,20 @@ export class FastMCPSession<
                 }, tool.timeoutMs);
               }),
             ])
-          : executeToolPromise);
-
-        if (typeof maybeStringResult === "string") {
+          : executeToolPromise)) as
+          | AudioContent
+          | ContentResult
+          | ImageContent
+          | null
+          | string
+          | TextContent
+          | undefined;
+
+        if (maybeStringResult === undefined || maybeStringResult === null) {
+          result = ContentResultZodSchema.parse({
+            content: [],
+          });
+        } else if (typeof maybeStringResult === "string") {
           result = ContentResultZodSchema.parse({
             content: [{ text: maybeStringResult, type: "text" }],
           });
@@ -1322,7 +1372,6 @@ export class FastMCP<
   #resources: Resource[] = [];
   #resourcesTemplates: InputResourceTemplate[] = [];
   #sessions: FastMCPSession<T>[] = [];
-  #sseServer: null | SSEServer = null;
 
   #tools: Tool<T>[] = [];
 
@@ -1371,13 +1420,9 @@ export class FastMCP<
   public async start(
     options:
       | {
-          httpStream: { endpoint: `/${string}`; port: number };
+          httpStream: { port: number };
           transportType: "httpStream";
         }
-      | {
-          sse: { endpoint: `/${string}`; port: number };
-          transportType: "sse";
-        }
       | { transportType: "stdio" } = {
       transportType: "stdio",
     },
@@ -1404,48 +1449,8 @@ export class FastMCP<
       this.emit("connect", {
         session,
       });
-    } else if (options.transportType === "sse") {
-      this.#sseServer = await startSSEServer<FastMCPSession<T>>({
-        createServer: async (request) => {
-          let auth: T | undefined;
-
-          if (this.#authenticate) {
-            auth = await this.#authenticate(request);
-          }
-
-          return new FastMCPSession<T>({
-            auth,
-            name: this.#options.name,
-            ping: this.#options.ping,
-            prompts: this.#prompts,
-            resources: this.#resources,
-            resourcesTemplates: this.#resourcesTemplates,
-            roots: this.#options.roots,
-            tools: this.#tools,
-            version: this.#options.version,
-          });
-        },
-        endpoint: options.sse.endpoint as `/${string}`,
-        onClose: (session) => {
-          this.emit("disconnect", {
-            session,
-          });
-        },
-        onConnect: async (session) => {
-          this.#sessions.push(session);
-
-          this.emit("connect", {
-            session,
-          });
-        },
-        port: options.sse.port,
-      });
-
-      console.info(
-        `[FastMCP info] server is running on SSE at http://localhost:${options.sse.port}${options.sse.endpoint}`,
-      );
     } else if (options.transportType === "httpStream") {
-      this.#httpStreamServer = await startHTTPStreamServer<FastMCPSession<T>>({
+      this.#httpStreamServer = await startHTTPServer<FastMCPSession<T>>({
         createServer: async (request) => {
           let auth: T | undefined;
 
@@ -1465,7 +1470,6 @@ export class FastMCP<
             version: this.#options.version,
           });
         },
-        endpoint: options.httpStream.endpoint as `/${string}`,
         onClose: (session) => {
           this.emit("disconnect", {
             session,
@@ -1482,7 +1486,7 @@ export class FastMCP<
       });
 
       console.info(
-        `[FastMCP info] server is running on HTTP Stream at http://localhost:${options.httpStream.port}${options.httpStream.endpoint}`,
+        `[FastMCP info] server is running on HTTP Stream at http://localhost:${options.httpStream.port}/stream`,
       );
     } else {
       throw new Error("Invalid transport type");
@@ -1493,9 +1497,6 @@ export class FastMCP<
    * Stops the server.
    */
   public async stop() {
-    if (this.#sseServer) {
-      await this.#sseServer.close();
-    }
     if (this.#httpStreamServer) {
       await this.#httpStreamServer.close();
     }

package/src/examples/addition.ts

@@ -1,8 +1,12 @@
 /**
- * This is an example of a FastMCP server that adds two numbers.
+ * Example FastMCP server demonstrating core functionality plus streaming output.
  *
- * If you are looking for a complete example of an MCP server repository,
- * see https://github.com/punkpeye/fastmcp-boilerplate
+ * Features demonstrated:
+ * - Basic tool with type-safe parameters
+ * - Streaming-enabled tool for incremental output
+ * - Advanced tool annotations
+ *
+ * For a complete project template, see https://github.com/punkpeye/fastmcp-boilerplate
  */
 import { type } from "arktype";
 import * as v from "valibot";
@@ -118,6 +122,39 @@ server.addResource({
   uri: "file:///logs/app.log",
 });
 
+server.addTool({
+  annotations: {
+    openWorldHint: false,
+    readOnlyHint: true,
+    streamingHint: true,
+  },
+  description: "Generate a poem line by line with streaming output",
+  execute: async (args, context) => {
+    const { theme } = args;
+    const lines = [
+      `Poem about ${theme} - line 1`,
+      `Poem about ${theme} - line 2`,
+      `Poem about ${theme} - line 3`,
+      `Poem about ${theme} - line 4`,
+    ];
+
+    for (const line of lines) {
+      await context.streamContent({
+        text: line,
+        type: "text",
+      });
+
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+
+    return;
+  },
+  name: "stream-poem",
+  parameters: z.object({
+    theme: z.string().describe("Theme for the poem"),
+  }),
+});
+
 server.addPrompt({
   arguments: [
     {
@@ -144,7 +181,6 @@ if (transportType === "httpStream") {
 
   server.start({
     httpStream: {
-      endpoint: "/stream",
       port: PORT,
     },
     transportType: "httpStream",