MCP & AI Agents

MCP server for AI agents

Connect TrueFTP to Claude, Cursor, VS Code, and other AI agents over the Model Context Protocol — manage FTP users, transfer files, and read events from natural language.

TrueFTP ships an MCP server so AI agents can operate your managed FTP account directly — create FTP users, move files, read the audit log, and configure webhooks — over the Model Context Protocol. It's a thin, audited layer over the REST API; every action runs under your API key's scopes and shows up in your activity log.

MCP is a paid feature. Create an API key under Dashboard → API Keys (available on paid plans). Free plans are rejected with a 403.

Tools

ToolScopeWhat it does
get_accountreadAccount plan, slug, quotas
list_ftp_usersreadList FTP/SFTP users
create_ftp_userwriteCreate an FTP user
update_ftp_userwriteUpdate permissions / password
delete_ftp_userwriteDelete an FTP user
list_filesreadList a folder (cursor-paginated, prefix search)
read_filereadRead a file (text or base64)
write_filewriteUpload / overwrite a file
delete_filewriteDelete a file or folder
make_directorywriteCreate a folder
list_eventsreadRecent file-operation audit events
list_webhooks / create_webhook / delete_webhookread/writeManage webhooks

Scopes come from the API key — a read-only key can list and read but not mutate.

Option 1 — Hosted (remote MCP)

Point your client at the hosted endpoint and send your API key as a Bearer token:

URL:    https://www.trueftp.com/mcp
Header: Authorization: Bearer tftp_xxxxxxxxxxxxxxxx

Works with clients that support remote MCP servers with custom headers (Cursor, VS Code, Claude Code).

Option 2 — Local (npx)

Run the server locally; it talks to the API with your key:

TRUEFTP_API_KEY=tftp_xxxx npx trueftp-mcp

Claude Code

claude mcp add trueftp --env TRUEFTP_API_KEY=tftp_xxxx -- npx -y trueftp-mcp

Cursor / Claude Desktop

Add to your mcp.json:

{
  "mcpServers": {
    "trueftp": {
      "command": "npx",
      "args": ["-y", "trueftp-mcp"],
      "env": { "TRUEFTP_API_KEY": "tftp_xxxx" }
    }
  }
}

Example prompts

Once connected, ask your agent things like:

  • "Create an FTP user partner-edi and give it write access to /incoming."
  • "List the files in /incoming for partner-edi and download the newest CSV."
  • "Upload this generated report to /outgoing as summary-2026.pdf."
  • "What were the last 10 file operations on the account?"
  • "Add a webhook to https://hooks.example.com/trueftp for file.uploaded events."

Security

  • Every call is authenticated by your tftp_ key and gated to paid plans.
  • Keys carry read / write scopes — issue a read-only key for agents that should only observe.
  • All file operations are logged (visible in Activity and via list_events) and versioned in the S3 backend.
  • Revoke a key anytime under API Keys to cut off an agent instantly.
All docs