@agentvalet/mcp-server 0.3.5 → 0.3.7

package/dist/index.js

@@ -51,20 +51,40 @@ const LIST_PLATFORMS_TOOL = {
     name: "list_platforms",
     description: "list_platforms: List the platforms and permission scopes this agent has access to.\nInput: None.\nReturns: { platforms: [{ platformId, platformName, scopes, requireApproval }], version: \"<hex>\" }.\nVersion: a deterministic hash that only changes when the platform set or scopes change. Cache the value across calls in the same session — only refresh when you suspect platforms have changed (e.g. user mentions a new connection).\nAuth: Bearer JWT.",
     inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            platforms: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        platformId: { type: "string" },
+                        platformName: { type: "string" },
+                        scopes: { type: "array", items: { type: "string" } },
+                        requireApproval: { type: "boolean" },
+                    },
+                    required: ["platformId", "platformName", "scopes"],
+                },
+            },
+            version: { type: "string" },
+        },
+        required: ["platforms"],
+    },
 };
 const USE_PLATFORM_TOOL = {
     name: "use_platform",
-    description: "use_platform: Call an external platform API (Airtable, GitHub, Slack, etc.) through the AgentValet proxy.\nInput: platform (string), endpoint (string), method (GET|POST|PUT|PATCH|DELETE), scope (string), data (object, optional).\nReturns: upstream API response body. May take up to 50 seconds when the action requires owner approval — the call will block while we wait, then return the approved result transparently. If approval doesn't land in time, returns a `pending_approval` envelope and the action runs asynchronously; the user is notified when it completes.\nAuth: Bearer JWT.",
+    description: "use_platform: Call an external platform API (Airtable, GitHub, Slack, Metabase, etc.) through the AgentValet proxy.\nInput: platform (string), endpoint (string), method (GET|POST|PUT|PATCH|DELETE), scope (string), body (object, optional — JSON request body for POST/PUT/PATCH/DELETE).\nReturns: upstream API response body. May take up to 50 seconds when the action requires owner approval — the call will block while we wait, then return the approved result transparently. If approval doesn't land in time, returns a `pending_approval` envelope and the action runs asynchronously; the user is notified when it completes.\nAuth: Bearer JWT.\nNote: legacy clients passing `data` instead of `body` are still accepted for backwards compatibility, but `body` is the canonical name.",
     inputSchema: {
         type: "object",
         properties: {
             platform: {
                 type: "string",
-                description: "Platform ID (e.g. airtable, github, slack)",
+                description: "Platform ID (e.g. airtable, github, slack, metabase)",
             },
             endpoint: {
                 type: "string",
-                description: "API path on the target platform (e.g. /v0/meta/bases)",
+                description: "API path on the target platform (e.g. /v0/meta/bases or /api/dataset)",
             },
             method: {
                 type: "string",
@@ -75,9 +95,13 @@ const USE_PLATFORM_TOOL = {
                 type: "string",
                 description: "Permission scope required for this action (e.g. records:read)",
             },
+            body: {
+                type: "object",
+                description: "JSON request body for POST/PUT/PATCH/DELETE. Optional. Forwarded verbatim to the upstream API.",
+            },
             data: {
                 type: "object",
-                description: "Optional request body for POST/PUT/PATCH requests",
+                description: "Deprecated alias for `body` — prefer `body`. Kept for backwards compatibility.",
             },
         },
         required: ["platform", "endpoint", "method", "scope"],
@@ -112,6 +136,17 @@ const AGENT_REGISTER_TOOL = {
         },
         required: ["owner_id", "agent_name", "requested_scopes"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            registration_token: { type: "string" },
+            poll_url: { type: "string" },
+            client_id: { type: "string" },
+            scope: { type: "string" },
+            expires_in: { type: "number" },
+        },
+        required: ["registration_token"],
+    },
 };
 const AGENT_STATUS_TOOL = {
     name: "agent_status",
@@ -126,6 +161,15 @@ const AGENT_STATUS_TOOL = {
         },
         required: ["token"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            status: { type: "string", enum: ["pending_approval", "approved", "rejected"] },
+            agent_id: { type: "string" },
+            mcp_config: { type: "object" },
+        },
+        required: ["status"],
+    },
 };
 const AUTHZEN_EVALUATE_TOOL = {
     name: "authzen_evaluate",
@@ -144,6 +188,14 @@ const AUTHZEN_EVALUATE_TOOL = {
         },
         required: ["platform_id", "scope"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            decision: { type: "boolean" },
+            context: { type: "object", properties: { reason: { type: "string" } } },
+        },
+        required: ["decision"],
+    },
 };
 const REPORT_SELF_DIAGNOSTIC_TOOL = {
     name: "report_self_diagnostic",
@@ -183,11 +235,55 @@ const REPORT_SELF_DIAGNOSTIC_TOOL = {
         },
         required: ["severity", "message"],
     },
+    outputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            received_at: { type: "string" },
+        },
+        required: ["id"],
+    },
 };
 const LIST_MY_PENDING_ACTIONS_TOOL = {
     name: "list_my_pending_actions",
     description: "list_my_pending_actions: Returns this agent's currently-pending approval requests AND any that completed in the last 24 hours. Use this at session start when the user mentions an earlier action, or when use_platform's long-poll timed out and the user comes back asking what happened.\nInput: None.\nReturns: { pending: [{approval_id, platform_id, scope, created_at, expires_at}], recently_completed: [{approval_id, platform_id, scope, status, executed_at, result_summary, execution_error}] }.\nAuth: Bearer agent JWT (sent automatically).",
     inputSchema: { type: "object", properties: {} },
+    outputSchema: {
+        type: "object",
+        properties: {
+            pending: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        approval_id: { type: "string" },
+                        platform_id: { type: "string" },
+                        scope: { type: "string" },
+                        created_at: { type: "string" },
+                        expires_at: { type: "string" },
+                    },
+                    required: ["approval_id", "platform_id", "scope"],
+                },
+            },
+            recently_completed: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        approval_id: { type: "string" },
+                        platform_id: { type: "string" },
+                        scope: { type: "string" },
+                        status: { type: "string" },
+                        executed_at: { type: "string" },
+                        result_summary: { type: "string" },
+                        execution_error: { type: "string" },
+                    },
+                    required: ["approval_id", "status"],
+                },
+            },
+        },
+        required: ["pending", "recently_completed"],
+    },
 };
 // TODO: intent_resolve tool — planned for future release
 // ---------------------------------------------------------------------------
@@ -259,12 +355,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             };
         }
         const progressToken = request.params._meta?.progressToken;
+        // Accept either `body` (canonical) or `data` (legacy alias). `body` wins
+        // when both are supplied. This matters because Claude (and other LLM
+        // hosts) reach for `body` as the natural HTTP terminology — the prior
+        // schema only declared `data` which made every POST get silently
+        // dropped to an empty body. See the use_platform tool description.
+        const bodyArg = (args.body ?? args.data);
         return await handleUsePlatform({
             platform: args.platform,
             endpoint: args.endpoint,
             method: args.method,
             scope: args.scope,
-            data: args.data,
+            data: bodyArg,
         }, progressToken);
     }
     if (name === "agent_register") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentvalet/mcp-server",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "AgentValet MCP server — lets AI agents call approved platforms via the AgentValet proxy",
   "type": "module",
   "main": "dist/index.js",