Drive Get File

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READgoogle.drive_get_file

• Contract tier: agent_ready
• Risk: read
• Catalog version: google-2026.07.12.2
• Descriptor hash: 828fe14ae4f077df99ad5edb85a8359092c18027f0a3123d753ac465499152cf

Use this read-only Google Drive tool to fetch metadata for one known file ID. Returns ID, name, MIME type, parents, and other requested fields. It reads the configured user's Google data through per-request OAuth, does not mutate provider state, and returns a normalized bounded envelope.

Request Body

{
  "jsonrpc": "2.0",
  "id": "google-drive-get-file-example",
  "method": "tools/call",
  "params": {
    "name": "google.drive_get_file",
    "arguments": {
      "file_id": "file_id_123",
      "fields": "fields_example"
    }
  }
}

Arguments Schema

{
  "type": "object",
  "title": "drive_get_fileArguments",
  "required": [
    "file_id"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "title": "Fields",
      "default": "",
      "description": "Optional Google partial-response fields selector for compact output."
    },
    "file_id": {
      "type": "string",
      "title": "File Id",
      "description": "Google Drive file ID."
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the local or Google provider operation completed successfully."
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Bounded local navigation or Google provider result when ok is true."
    },
    "meta": {
      "type": "object",
      "description": "Safe timing, pagination, cache, request, and truncation metadata.",
      "additionalProperties": true
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ],
      "description": "Safe structured error when ok is false."
    }
  },
  "description": "Google MCP normalized operation envelope.",
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "google-drive-get-file-example",
  "method": "tools/call",
  "params": {
    "name": "google.drive_get_file",
    "arguments": {
      "file_id": "file_id_123",
      "fields": "fields_example"
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "google-drive-get-file-example",
  "method": "tools/call",
  "params": {
    "name": "google.drive_get_file",
    "arguments": {
      "file_id": "file_id_123",
      "fields": "fields_example"
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "google-drive-get-file-example",
  "method": "tools/call",
  "params": {
    "name": "google.drive_get_file",
    "arguments": {
      "file_id": "file_id_123",
      "fields": "fields_example"
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool google.drive_get_file executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}