# Upload to URL — MCP server on mcp.ai
> Connect your Upload to URL account and use 5 tools for file management and storage straight from your AI agent. Connect with your own API key. Upload files to public CDN URLs, retrieve or delete uploaded file metadata, and publish HTML pages.

By: mcp.ai · official
Page: https://mcp.ai/upload_to_url

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_upload_to_url?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/upload_to_url/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/upload_to_url/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/upload_to_url/skill.md
Postman collection (v2.1): https://mcp.ai/upload_to_url/postman.json

## Tools
- upload_to_url_delete_file(file_id: string) — Permanently delete a previously uploaded file from storage and its public CDN location.
- upload_to_url_get_file_metadata(file_id: string) — Retrieve current metadata and the public CDN URL for a file previously uploaded by the connected account.
- upload_to_url_get_supported_formats() — Return the file extensions Upload to URL accepts or blocks, current plan size limits, and advertised upload security checks. Use this before uploading an unfamiliar file type.
- upload_to_url_publish_html(html_code: string, page_path: string, subdomain?: string, expiry_days?: string) — Publish raw HTML at a public URL under a chosen page path. This irreversible public side effect consumes one monthly credit, and the API provides no way to delete the published page.
- upload_to_url_upload_file(file: object, source?: string, expiry_days?: string) — Upload one file and return its public CDN URL, file ID, expiration, and remaining monthly credits. Each successful call consumes one upload credit.

## Example prompts
- "What can I do in Upload to URL?"
- "Show me a summary of my Upload to URL account"

## Links
Docs: https://mcp.ai/docs/mcps/upload_to_url
Website: https://mcp.ai/mcps/upload_to_url