Skip to main content

Files.com MCP Server

Base URL: https://.files.com/api/rest/v1

Category Storage
Tools 195
Auth API Key

API Info


Install

Quick Start (recommended)

API_KEY=YOUR_API_KEY \
SERVER_SUBDOMAIN=YOUR_SERVER_SUBDOMAIN \
uvx mcparmory-files-com

With pip

pip install mcparmory-files-com
API_KEY=YOUR_API_KEY \
SERVER_SUBDOMAIN=YOUR_SERVER_SUBDOMAIN \
mcparmory-files-com

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop, Cursor, Codex):

{
  "mcpServers": {
    "files-com": {
      "command": "uvx",
      "args": ["mcparmory-files-com"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "SERVER_SUBDOMAIN": "YOUR_SERVER_SUBDOMAIN"
      }
    }
  }
}

Credentials

Set the following environment variables (via MCP client env config, shell export, or .env file):

  • API_KEY — API Key Authentication (X-FilesAPI-Key)
  • SERVER_SUBDOMAIN — User-specific value for subdomain

Do not commit credentials to version control.


Run Locally

First, configure your credentials in .env (see Credentials above).

pip install -r requirements.txt
python server.py

Connect MCP Client

Edit .mcp.json and replace <SERVER_DIR> with the absolute path to this directory, then add to your MCP client configuration.

Example (if server is at /home/user/mcp-servers/files-com):

{
  "mcpServers": {
    "files-com": {
      "command": "python",
      "args": ["/home/user/mcp-servers/files-com/server.py"]
    }
  }
}

Docker

Pre-built image (recommended)

docker run -p 8000:8000 \
  -e API_KEY=YOUR_API_KEY \
  -e SERVER_SUBDOMAIN=YOUR_SERVER_SUBDOMAIN \
  ghcr.io/mcparmory/files-com:latest

Build from source

First, configure your credentials in .env (see Credentials above).

docker build -t files-com .
docker run -p 8000:8000 --env-file .env files-com

Before running, make sure ports 8000 are free.### MCP client config (Docker)

For Docker, use SSE transport in your MCP client config:

{
  "mcpServers": {
    "files-com": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

Files

  • .env - Credentials and server configuration
  • .mcp.json - MCP client config template
  • Dockerfile - Container build
  • LICENSE - MIT license for this generated code
  • requirements.txt - Python dependencies
  • README.md - This file
  • server.py - MCP server entry point
  • _auth.py - Authentication handlers
  • _models.py - Request/response models
  • _validators.py - Input validation

Note: Files starting with . are hidden by default on macOS/Linux. Use ls -a in terminal or enable "Show hidden files" in your file manager to see .env and .mcp.json.


MCP Blacksmith
Generated by MCP Blacksmith · Quickstart docs · Report a bug

Metadata

Release files for mcparmory-files-com 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for mcparmory-files-com 1.0.3
File Interpreter ABI Platform
mcparmory_files_com-1.0.3-py3-none-any.whl Python 3 none any Details

Release files / mcparmory_files_com-1.0.3-py3-none-any.whl

Download URL mcparmory_files_com-1.0.3-py3-none-any.whl
Size 108.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2e72e40fdde69c9a7a14d09d58544a7bf0d47f435001476f5a4ce9b2f1344d51
BLAKE2b-256 checksum
How to use checksums
9a976a8824a17ec7e1e01b9b0bfffc6deaaf9a2b1589ecacff296400395a5f66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for mcparmory-files-com 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page