# GoFile — how to use (mcp.ai)

Connect your GoFile account and use 5 tools for file management and storage straight from your AI agent. Connect with your own API key. GoFile is a file storage and sharing service for uploading, organizing, and distributing files.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gofile?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gofile_create_folder`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gofile`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gofile/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gofile/create/folder` — Create a private folder inside an existing GoFile folder.
  - body: { folder_name: string, parent_folder_id: string }
- `POST https://api.mcp.ai/api/gofile/delete/contents` — Permanently and irreversibly delete one or more explicitly selected owned GoFile files or folders.
  - body: { content_ids: string[] }
- `POST https://api.mcp.ai/api/gofile/get/current/account` — Return the connected GoFile account's identity, tier, root folder, usage, and content counts without exposing account credentials or network metadata.
- `POST https://api.mcp.ai/api/gofile/rename/content` — Rename one owned GoFile file or folder.
  - body: { new_name: string, content_id: string }
- `POST https://api.mcp.ai/api/gofile/upload/file` — Upload one file into an existing folder owned by the connected GoFile account.
  - body: { file: object, folder_id: string }

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

## More
- Page: https://mcp.ai/gofile
- Agent spec (llms.txt): https://mcp.ai/gofile/llms.txt
- Postman collection: https://mcp.ai/gofile/postman.json