# IBM Aspera CLI

> IBM Aspera CLI is an open-source MCP server for files and documents. Command-line and MCP interface for automating IBM Aspera transfers and admin tasks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, API, self-hosted
- **Website:** https://ibm.github.io/aspera-cli/
- **Repository:** https://github.com/ibm/aspera-cli
- **MCP Registry name:** io.github.IBM/aspera-cli
- **Categories:** files and documents
- **Listing updated:** 2026-11-18

## About

The README says ascli is an open-source toolkit for driving IBM Aspera products from a terminal, from scripts, or from AI clients. Its per-product plugins cover Aspera on Cloud, Faspex 5, Shares, the High-Speed Transfer Server, Console, Orchestrator, Cloud Object Storage and several gateways, so one tool can handle transfers, packages, files and administration across that ecosystem.

Beyond moving files with FASP, it can output results as JSON, YAML, CSV or tables, keep environment-specific presets and secrets in a vault, and analyze ascp logs to explain failed or slow transfers. Access for AI assistants runs through an MCP server started with a single command, and the project states that the AI never sees secrets and cannot run arbitrary code or write files where it chooses.

The tool suits Aspera administrators, integration engineers and developers who need to script or automate high-speed transfers and want AI agents to operate the same commands. It is distributed as a Ruby gem and as a container image.

## Features

- **Multi-product Aspera plugins:** Separate plugins cover Aspera on Cloud, Faspex 5, Shares, Console, Orchestrator, COS and other Aspera products under one command.
- **Structured command output:** Results can be returned as JSON, YAML, CSV or tables and filtered with JMESPath for use in scripts.
- **Vault-backed presets:** Per-environment presets and secrets are stored in a vault so credentials stay out of scripts.
- **ascp log diagnostics:** The tool analyzes ascp log files to help explain why a transfer failed or runs slowly.
- **Secret-safe MCP server:** The MCP server exposes commands to AI clients over stdio or HTTPS, with token or OAuth authentication and no secret exposure.
- **Demo server quickstart:** A built-in configuration points at the public Aspera demo server so users can try commands without an account.

## Good for

- Scripting scheduled high-speed file transfers from the command line
- Browsing and managing files and packages across Aspera on Cloud or Faspex 5
- Letting an AI assistant run Aspera administration tasks through MCP
- Diagnosing slow or failed ascp transfers from log files
- Integrating Aspera REST APIs into CI/CD or monitoring pipelines

## Install

### Claude Code (Terminal)

```sh
claude mcp add aspera-cli -- docker run -i --rm docker.io/martinlaurent/ascli:4.29.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aspera-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/martinlaurent/ascli:4.29.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aspera-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/martinlaurent/ascli:4.29.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aspera-cli": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/martinlaurent/ascli:4.29.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aspera-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/martinlaurent/ascli:4.29.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aspera-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/martinlaurent/ascli:4.29.0"
      ]
    }
  }
}
```

## FAQ

### How is the MCP server started?

The README says to install the optional mcp gem alongside aspera-cli, then run ascli mcp server, declared in an MCP client config with the command ascli and args mcp and server.

### Is it open source?

Yes. The README states it is open source under the Apache-2.0 licence, by IBM.

### Does it need an Aspera account to try?

No. The README says the public Aspera demo server is preconfigured for the initial demo commands.

### What does the AI get access to?

The README says the AI can neither execute code nor write files where it chooses, and never sees secrets.

### Is IBM Aspera CLI free?

Yes. IBM Aspera CLI is open source, so you can use and self-host it for free.

### How do I add IBM Aspera CLI to Claude Code?

Run this command in your terminal: claude mcp add aspera-cli -- docker run -i --rm docker.io/martinlaurent/ascli:4.29.0

### What are the best alternatives to IBM Aspera CLI?

The closest alternatives to IBM Aspera CLI are SSRS2, ASTra, CARTESIAN ECU, Invoices and SigPen.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/ibm-aspera-cli
