# X02 > Free file hosting with an API and an MCP server. Upload images, video, > PDFs and documents, get direct links, custom subdomains, folders and > shared albums — or let an AI assistant do it for you. X02 is at https://x02.me. AI chat assistants (Claude, ChatGPT, Gemini, Grok, Le Chat, and developer tools such as Claude Code and Cursor) connect to the remote MCP server at https://up.x02.me/mcp over Streamable HTTP with OAuth 2.1 as a custom connector — the user signs in on x02.me and never pastes an API key into the assistant. It has fifteen tools for uploading, searching, viewing, renaming, moving, deleting, organizing and sharing files. The REST API is at https://up.x02.me/api (https://x02.me/api-docs). Every page listed here is also available as markdown: append .md to a blog URL, use https://x02.me/index.md for the homepage, or send Accept: text/markdown. ## Start here - [Use X02 with AI assistants](https://x02.me/ai): The MCP server — setup for each app, tools, permissions. Markdown: https://x02.me/ai.md - [X02 overview](https://x02.me/): What X02 is, plans and limits, file types. Markdown: https://x02.me/index.md - [API documentation](https://x02.me/api-docs): Every REST endpoint with parameters, curl examples and responses. Markdown: https://x02.me/api-docs.md - [Full text](https://x02.me/llms-full.txt): This whole site, including every article, in one file. ## Connecting an AI assistant (MCP) - [How to Send Files to X02 From an AI Chat](https://x02.me/blog/how-to-send-files-to-x02-from-an-ai-chat): Four ways a file gets from your machine into X02 through an assistant — inline upload, rehosting from a URL, drop links and the standing tray — with the size ceilings and expiry times for each. - [Set Up X02 in Claude, ChatGPT, Grok and More](https://x02.me/blog/set-up-x02-mcp-in-your-ai-client): Step-by-step setup for connecting X02 to Claude, ChatGPT, Grok, Cursor, Windsurf and VS Code, with a general recipe for any other MCP app and the plan requirements that trip people up. - [Troubleshooting X02 MCP Connections](https://x02.me/blog/troubleshooting-x02-mcp-connections): Every way an X02 MCP connection fails, what the error actually means, and the fix — from empty tool lists and stale sign-ins to scope refusals, expired drop links and uploads that will not go through. - [X02 MCP Permissions: What You Are Actually Approving](https://x02.me/blog/x02-mcp-permissions-and-scopes-explained): A close read of the consent screen. Which scope governs which tool, how enforcement works on every call, how long tokens live, what revocation really does, and which permissions to withhold. - [Ten Things to Ask an Assistant Connected to X02](https://x02.me/blog/x02-mcp-workflows-and-recipes): Worked examples rather than a tool reference — finding a file by the name it had on your machine, tidying a month of uploads into folders, publishing an album, and batch jobs that need a quota check first. - [Connect AI Assistants to X02 with MCP](https://x02.me/blog/connect-ai-assistants-to-x02-with-mcp): Connect Claude, Cursor, or any Model Context Protocol client to your X02 account. Upload, search, organize, and share files by asking — with scoped, revocable access and no API key pasted into the client. - [How to Upload Files to X02](https://x02.me/blog/how-to-upload-files-to-x02): A complete, easy-to-follow guide to uploading files on X02. Start with simple browser drag-and-drop and clipboard pasting, then explore developer workflows using cURL, REST APIs, MCP, and desktop tools. ## Guides - [All X02 Features and Capabilities](https://x02.me/blog/all-features-and-capabilities): The complete directory of all features, capabilities, and integrations available on the X02 file hosting and media infrastructure platform. - [How to Connect Discord and Google Accounts to X02](https://x02.me/blog/how-to-connect-discord-and-google-accounts): A complete guide to linking your Discord and Google accounts with X02 for seamless 1-click logins, bot integrations, and secure account management. - [How to Get an API Key](https://x02.me/blog/how-to-get-an-api-key): A simple guide to finding, copying, generating, and regenerating your X02 API key for developer scripts, bots, and ShareX integrations. - [How to Integrate ShareX with X02](https://x02.me/blog/how-to-integrate-sharex-with-x02): A complete step-by-step guide to connecting ShareX with X02. Capture screenshots, annotate on the fly, and automatically copy direct shareable links to your clipboard in under one second. - [How to Organize Files with Folders](https://x02.me/blog/how-to-organize-files-with-folders): A complete guide to organizing your media library on X02. Create custom folders, set default upload destinations, generate direct folder keys, enable password protection, and invite team collaborators. - [How to Rename Your Uploaded Files](https://x02.me/blog/how-to-rename-uploaded-files): A complete guide on how to rename your uploaded files on X02. Turn messy screenshot names into clean, readable vanity URLs using the dashboard or developer REST API. - [How to Replace a File Without Changing Its Link](https://x02.me/blog/how-to-replace-file-without-changing-link): Learn how to update or swap an uploaded file on X02 while keeping the exact same URL and folder settings. Includes simple visual dashboard steps and developer REST API references. - [How to Set a Default Upload Folder](https://x02.me/blog/how-to-set-a-default-upload-folder): Learn how to designate a default upload folder on X02 so all your incoming web, clipboard, ShareX, and API uploads are automatically organized into the right place. - [How to Switch Between Short URLs and Subdomain URLs](https://x02.me/blog/how-to-switch-between-short-urls-and-subdomains): Learn how to choose between compact short URLs (x02.me/u/...) and personalized subdomain links (username.x02.me/i/...) for your uploads on X02. - [Building High-Throughput Discord Support & Ticket Infrastructure with X02](https://x02.me/blog/building-discord-ticket-infrastructure): A comprehensive architectural guide to deploying resilient Discord ticket panels, automated HTML transcript generation, moderator claiming workflows, and high-volume channel lifecycle management. - [Architecture of Real-Time NSFW Detection & Quarantine at Scale](https://x02.me/blog/realtime-nsfw-detection-at-scale): A deep technical dive into X02-Vision AI: convolutional neural network inference pipelines, sub-100ms latency benchmarks, multi-stage content verification, and automated quarantine isolation workflows. - [Why Discord CDN URLs Expire and How to Build a Permanent Media Rehosting Pipeline](https://x02.me/blog/discord-cdn-expiration-permanent-media): An architectural analysis of Discord's CDN attachment expiration policy (HMAC signed query parameters), its impact on bots, websites, and webhooks, and how to build an automated rehosting pipeline with Node.js and Python. - [Branded File Hosting: Configuring Your Custom Domain & Edge SSL](https://x02.me/blog/branded-file-hosting-custom-subdomains): A complete networking and DNS tutorial for branding your uploads with your own custom domain, setting up CNAME and TXT records, Cloudflare edge proxying, and automated zero-touch SSL provisioning on X02. - [Architecting High-Performance File Uploads: Chunking, Streams, and S3-Compatible Storage](https://x02.me/blog/high-performance-file-uploads-architecture): An engineering deep dive into building ultra-fast, resilient file upload infrastructure: comparing multipart chunking, direct-to-R2/S3 presigned URLs, streaming pipelines, and token bucket rate limiters. ## Reference - [How X02 works](https://x02.me/how-it-works): The upload flow, limits and moderation in brief. - [Changelog](https://x02.me/changelog): Every release, newest first. - [MCP server card](https://x02.me/.well-known/mcp.json): Machine-readable description of the MCP server. - [All articles](https://x02.me/blog): Every guide, newest first. - [RSS feed](https://x02.me/rss.xml): Machine-readable index of all articles.