# Files.com — how to use (mcp.ai)

Connect your Files.com account and use 7 tools for file management and storage straight from your AI agent. Connect with your own API key. Files.com is a secure cloud storage and file transfer platform that enables businesses to store, share, and manage files across various cloud services and on-premises systems.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_files_com?ms=1787291520000`
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. `files_com_delete_api_key`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/files_com`
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/files_com/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/files_com/delete/api/key` — Tool to delete an API key. Use when you need to revoke an API key after confirming its identifier.
  - body: { api_key_id: integer }
- `POST https://api.mcp.ai/api/files_com/delete/permission` — Removes a permission grant that allows a user or group to access a specific file or folder path on Files.com. A permission ID can be obtained from the LIST_PERMISSIONS action. Use this tool when you n
  - body: { permission_id: integer }
- `POST https://api.mcp.ai/api/files_com/delete/share` — Delete a specified share link (bundle) on Files.com. This operation is idempotent - it succeeds even if the share link has already been deleted or doesn't exist. Use this to revoke public access to sh
  - body: { share_id: integer }
- `POST https://api.mcp.ai/api/files_com/get/s3/key/for/upload` — Tool to generate a temporary key for file uploads by uploading the file to Files.com. Useful when you need to host a local file temporarily before importing or sharing.
  - body: { file: object }
- `POST https://api.mcp.ai/api/files_com/list/folders` — Lists folders in Files.com with optional filtering, sorting, and pagination. Returns a paginated list of folders with metadata. Useful for browsing folder structure, finding specific folders by name, 
  - body: { page?: integer, search?: string, per_page?: integer, parent_id?: integer, sort_by_path?: string }
- `POST https://api.mcp.ai/api/files_com/list/groups` — Retrieves a paginated list of all groups from Files.com. Groups are used to organize users and manage permissions collectively. Use this action to discover available groups, check group membership, or
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/files_com/list/permissions` — Retrieve permissions for a specified path on Files.com. Use when you need to inspect who has access and what level for a given file or folder path.
  - body: { page?: integer, path?: string, user_id?: string, group_id?: string, per_page?: integer, partner_id?: string, include_groups?: boolean }

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

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