add support for function/asset upload

packages/mcp/package.json

@@ -34,11 +34,13 @@
     "@apidevtools/swagger-parser": "^10.1.1",
     "@modelcontextprotocol/sdk": "^1.7.0",
     "@twilio-alpha/openapi-mcp-server": "0.4.0",
+    "form-data": "^4.0.2",
     "inquirer": "^12.5.0",
     "minimist": "^1.2.8",
     "openapi-types": "^12.1.3"
   },
   "devDependencies": {
+    "@types/form-data": "^2.2.1",
     "@types/minimist": "^1.2.5",
     "@types/node": "^22.13.10",
     "@typescript-eslint/eslint-plugin": "^7.18.0",

packages/mcp/src/server.ts

@@ -13,6 +13,7 @@ import {
 
 import { Credentials } from '@app/types';
 import { toolRequiresAccountSid } from '@app/utils';
+import { loadAdditionalTools, uploadFunction, uploadAsset } from '@app/tools';
 
 type Configuration = {
   server: {
@@ -104,6 +105,21 @@ export default class TwilioOpenAPIMCPServer extends OpenAPIMCPServer {
     throw new Error(`Resource ${name} not found`);
   }
 
+  protected async makeRequest(
+    id: string,
+    api: API,
+    body?: Record<string, unknown>,
+  ) {
+    if (id === uploadFunction.name && body) {
+      return uploadFunction.uploadFunctionExecution(body, this.http);
+    }
+    if (id === uploadAsset.name && body) {
+      return uploadAsset.uploadAssetExecution(body, this.http);
+    }
+
+    return super.makeRequest(id, api, body);
+  }
+
   /**
    * Loads resources for the server
    * @returns
@@ -128,5 +144,11 @@ export default class TwilioOpenAPIMCPServer extends OpenAPIMCPServer {
         this.tools.set(id, updatedTool);
       }
     }
+
+    const additionalTools = loadAdditionalTools(this.configuration?.filters);
+    for (const [id, { tool, api }] of additionalTools) {
+      this.tools.set(id, tool);
+      this.apis.set(id, api);
+    }
   }
 }

packages/mcp/src/tools/additionalTools.ts

@@ -0,0 +1,34 @@
+import { Tool } from '@modelcontextprotocol/sdk/types';
+import { API, ToolFilters } from '@twilio-alpha/openapi-mcp-server';
+import { uploadFunctionDefinition, uploadFunctionAPI } from './uploadFunction';
+import { uploadAssetDefinition, uploadAssetAPI } from './uploadAsset';
+
+type Additional = {
+  tool: Tool;
+  api: API;
+};
+export default function loadAdditionalTools(
+  filters?: ToolFilters,
+): Map<string, Additional> {
+  const tools: Map<string, Additional> = new Map();
+
+  const shouldIncludeServerless =
+    !filters ||
+    (filters.services &&
+      filters.services.some((s) => s.includes('serverless'))) ||
+    (filters.tags && filters.tags.some((t) => t.includes('Serverless')));
+
+  if (shouldIncludeServerless) {
+    tools.set(uploadFunctionDefinition.name, {
+      tool: uploadFunctionDefinition,
+      api: uploadFunctionAPI,
+    });
+
+    tools.set(uploadAssetDefinition.name, {
+      tool: uploadAssetDefinition,
+      api: uploadAssetAPI,
+    });
+  }
+
+  return tools;
+}

packages/mcp/src/tools/index.ts

@@ -0,0 +1,3 @@
+export { default as loadAdditionalTools } from './additionalTools';
+export * as uploadFunction from './uploadFunction';
+export * as uploadAsset from './uploadAsset';

packages/mcp/src/tools/uploadAsset.ts

@@ -0,0 +1,91 @@
+import FormData from 'form-data';
+import { Tool } from '@modelcontextprotocol/sdk/types';
+import { Http } from '@twilio-alpha/openapi-mcp-server/build/utils';
+import { HttpResponse } from '@twilio-alpha/openapi-mcp-server/build/utils/http';
+import { API } from '@twilio-alpha/openapi-mcp-server';
+
+export const name = 'TwilioServerlessV1--UploadServerlessAsset';
+
+export const uploadAssetExecution = async (
+  params: Record<string, any>,
+  http: Http,
+): Promise<HttpResponse<unknown>> => {
+  const { serviceSid, assetSid, path, visibility, content, contentType } =
+    params;
+
+  try {
+    const serviceUrl = `https://serverless-upload.twilio.com/v1/Services/${serviceSid}`;
+    const uploadUrl = `${serviceUrl}/Assets/${assetSid}/Versions`;
+
+    const form = new FormData();
+    form.append('Path', path);
+    form.append('Visibility', visibility);
+    const buffer = Buffer.from(content, 'utf-8');
+    form.append('Content', buffer, {
+      filename: 'asset',
+      contentType,
+    });
+
+    return await http.upload<{ sid: string }>(uploadUrl, form);
+  } catch (error) {
+    return {
+      ok: false,
+      statusCode: 500,
+      // @ts-ignore
+      error,
+    };
+  }
+};
+
+// these are unused - it's a stub
+export const uploadAssetAPI: API = {
+  method: 'POST',
+  contentType: 'multipart/form-data',
+  path: 'fake',
+};
+
+export const uploadAssetDefinition: Tool = {
+  name,
+  description:
+    "Create a new Asset resource. Assets are static files like HTML, CSS, images, or client-side JavaScript files that can be referenced by your Serverless Functions or served directly to clients. You must create a Service before creating Assets. After creating an Asset, you'll need to create Asset Versions to add the actual content.",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      serviceSid: {
+        type: 'string',
+        description:
+          'The SID of the Twilio Serverless Service where the asset will be uploaded',
+      },
+      assetSid: {
+        type: 'string',
+        description: 'The SID of the Asset to create a new version for',
+      },
+      path: {
+        type: 'string',
+        description: 'The HTTP path used to invoke the asset (e.g., "/thanos")',
+      },
+      visibility: {
+        type: 'string',
+        description:
+          'The visibility of the asset, typically "public" or "private"',
+      },
+      content: {
+        type: 'string',
+        description: 'The content of the Asset',
+      },
+      contentType: {
+        type: 'string',
+        description:
+          'The content type of the Asset being uploaded. This must match the actual content of the file.',
+      },
+    },
+    required: [
+      'serviceSid',
+      'assetSid',
+      'path',
+      'visibility',
+      'content',
+      'contentType',
+    ],
+  },
+};