Media & Storage

Upload documents, images, and videos that your AI agents can access through built-in MCP tools. Give your agents context from your own files.

Overview

MCP Gateway Pro includes a built-in media server that exposes your uploaded files as MCP tools. When you upload a document, image, or video through the console, any AI agent connected to your gateway can list and retrieve those files.

Text content is automatically extracted from PDFs and text files, so agents can read document contents directly without needing a separate parser.

Storage pricing: Media storage is metered at $0.50/GB per month.

1

Upload Files

Navigate to MCP Gateway → Storage in the console. Drag and drop files onto the upload area, or click to browse.

You can upload multiple files at once. Each file can be up to 500 MB.

Supported file types

Documents & Code

.pdf .txt .md .json .yaml .csv .py .js .ts .html .sql .go .rs .java and more

Images & Video

.png .jpg .gif .webp .mp4 .mov .webm

2

Access from AI Agents

Uploaded files are automatically available to any AI agent connected to your gateway through two built-in tools:

media__list_media

Returns a list of all uploaded files with their metadata (filename, size, type, upload date). 

{
  "method": "tools/call",
  "params": {
    "name": "media__list_media",
    "arguments": {}
  }
}

media__get_media

Retrieves the content of a specific file. The response format depends on the file type: 

{
  "method": "tools/call",
  "params": {
    "name": "media__get_media",
    "arguments": {
      "media_id": "your-media-id"
    }
  }
}
PDF

Returns extracted text content from all pages

Text

Returns the raw file contents (code, markdown, CSV, etc.)

Image

Returns base64-encoded image data for inline display

Video

Returns a temporary signed URL valid for 1 hour

3

Automatic Text Extraction

When you upload a PDF or text-based file, the gateway automatically extracts the text content and stores it alongside the original. This means your agents can read document contents directly — no additional parsing required.

Example: Upload a 50-page product spec PDF. Your agent calls media__get_media and receives the full text, ready to answer questions about the document.

Text extraction is supported for PDFs and all text-based formats (source code, markdown, CSV, JSON, YAML, etc.).

Storage & Billing

Your storage usage is tracked in the console under MCP Gateway → Storage. The usage indicator shows your current consumption.

Tier Price
Media Storage $0.50 / GB / month

Storage is metered hourly alongside your request and server-hour usage. See Billing & Pricing for full details.

Managing Files

The Storage page in the console lets you view all uploaded files, check their type and size, and delete files you no longer need. Deleted files are removed immediately from both storage and agent access.

What's Next?