MCPHerramientas MCP/Multimedia/upload_asset

upload_asset

Writemedia:write

Upload a new file (e.g. a photo, image, PDF, or other file) into the agency's media library. Provide the file as a public https URL (fetched and stored — a URL pointing at a private/internal network address is rejected) or as base64 bytes. Max 100 MB. Optionally scope it to an account/client/location/brand, drop it straight into a folder, tag it, or associate it with locations. Returns the created asset (including its key, used by update_asset/delete_asset and folder/tag operations).

Parámetros

urlstringopcional

A public https URL to fetch and store. Use this OR base64.

base64stringopcional

Raw file bytes as base64 (a data: URL prefix is accepted). Use this OR url.

mimestringopcional

The file's MIME type. Inferred from the URL response or a data: URL prefix when omitted; required for plain base64 without a data: URL prefix.

filenamestringopcional

Filename to store. Defaults to the URL's basename, or "upload".

titlestringopcional

Display title. Defaults to the filename.

scopeType"account" | "client" | "location" | "brand"opcional

Which kind of entity this asset belongs to.

scopeIdstringopcional

The id of the scoped entity (required together with scopeType) — a client id (list_clients) or location id (list_locations) for those two scope types; account/brand scoping has no lookup tool in this MCP surface.

folderIdstringopcional

A folder id (from list_asset_folders) to place this asset into immediately.

tagsstring[]opcional

Tag names to apply immediately (created if they don't already exist).

locationIdsstring[]opcional

Location ids (from list_locations) to associate this asset with.

Solicitud de ejemplo

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "upload_asset",
    "arguments": {}
  }
}

Respuesta de ejemplo

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

La forma de la respuesta se muestra a modo ilustrativo — el contenido real depende de la herramienta y de tus datos.