fix(mcp): declare request bodies and annotation titles (#8827)

Author: waleedlatif1

apps/sim/lib/api/mcp/server.ts

@@ -66,7 +66,11 @@ const callInput = z
       .record(z.string(), z.string())
       .optional()
       .describe('Request headers the operation declares, such as upload-token.'),
-    body: z.unknown().optional().describe('JSON request body, as describe_operation specifies.'),
+    body: z
+      .record(z.string(), z.unknown())
+      .meta({ additionalProperties: true })
+      .optional()
+      .describe('JSON request body, as describe_operation specifies.'),
   })
   .strict()
 
@@ -109,7 +113,12 @@ export function createSimMcpServer(context: Omit<McpDispatchContext, 'signal'>):
       description:
         'Find Sim API operations by keyword or domain. Returns each operation’s name, HTTP method, path, summary, and the tool that runs it. Call without a query to list a domain.',
       inputSchema: searchInput,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+      annotations: {
+        title: 'Search operations',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+      },
     },
     async (input) => jsonToolResult(await searchOperations(input))
   )
@@ -121,7 +130,12 @@ export function createSimMcpServer(context: Omit<McpDispatchContext, 'signal'>):
       description:
         'Get the JSON Schema of an operation’s path parameters, query, body, and headers. Read it before calling an operation for the first time.',
       inputSchema: describeInput,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+      annotations: {
+        title: 'Describe operation',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+      },
     },
     async ({ operation }) => {
       const resolved = await resolveOperation(operation, 'any')
@@ -138,7 +152,12 @@ export function createSimMcpServer(context: Omit<McpDispatchContext, 'signal'>):
       description:
         'Run a Sim API operation that only reads, such as listWorkspaces, listTables, queryRows, or getWorkflowRun. search_operations says which tool runs each operation.',
       inputSchema: callInput,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+      annotations: {
+        title: 'Read from Sim',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+      },
     },
     async (input, extra) => call('read', input, extra.signal)
   )
@@ -151,6 +170,7 @@ export function createSimMcpServer(context: Omit<McpDispatchContext, 'signal'>):
         'Run a Sim API operation that creates, changes, runs, or deletes something, such as createTable, executeWorkflow, or deleteFile.',
       inputSchema: callInput,
       annotations: {
+        title: 'Change Sim',
         readOnlyHint: false,
         destructiveHint: true,
         idempotentHint: false,