Expertise·Files & Storage

MinIO Client (mc)

Use when driving mc, the MinIO AIStor command-line client for S3-compatible object storage, from a shell — aliases, listing, copying…

You say
Buy it · $29 Read it before you buy $29 Written by minio · unverified publisher
Context cost
8.5k tokensestimated from the bundle, loaded when it triggers
Bundle
8 files · 34.1 kBtext throughout, nothing executable
Licence
Apache-2.0paid listing
Last change
no release on file
Servers it uses
Noneruns standalone

What it does

Use when driving mc, the MinIO AIStor command-line client for S3-compatible object storage, from a shell — connecting to a server with an alias, listing/copying/moving/removing objects and buckets, or configuring versioning, replication, lifecycle, encryption, policies, events, cluster administration, and AIStor Tables. Covers how an agent should authenticate non-interactively, get machine-readable JSON-lines output, build ALIAS/BUCKET/PREFIX paths, discover any command's exact flags, and stay clear of the irreversible destructive operations.

Installed, it changes the agent in these ways.

What this skill changes about the agent is not written down here yet. The listing was collected from its source, and the description is in its own SKILL.md.

Expertise

Domain judgement the base model does not have.

s3object-storagecliminio
Filed under

Files & Storage

The skill itself

This is the whole product. A skill is instructions the model reads, so there is nothing behind the listing you cannot see first — the front matter loads with every session, and the body below it loads when the skill triggers.

SKILL.md8.2 kB · 154 lines
--- name: mc description: Use when driving mc, the MinIO AIStor command-line client for S3-compatible object storage, from a shell — connecting to a server with an alias, listing/copying/moving/removing objects and buckets, or configuring versioning, replication, lifecycle, encryption, policies, events, cluster administration, and AIStor Tables. Covers how an agent should authenticate non-interactively, get machine-readable JSON-lines output, build ALIAS/BUCKET/PREFIX paths, discover any command's exact flags, and stay clear of the irreversible destructive operations. license: Apache-2.0 compatibility: Requires the `mc` binary (MinIO AIStor client) on PATH and network access to at least one S3-compatible endpoint. metadata: maintainer: MinIO homepage: https://docs.min.io ---
11# mc — MinIO AIStor command-line client
12
13mc is a single static binary that talks to any S3-compatible object store
14(MinIO AIStor, MinIO, AWS S3, and others) and to the local filesystem. It has
15two surfaces: **data-plane** commands that move and inspect objects and
16buckets over the S3 API (ls, cp, rm, mirror, …), and **control-plane**
17mc admin commands that manage an AIStor/MinIO server itself (users, config,
18healing, replication, tiering). A separate mc table surface manages AIStor
19Iceberg Tables.
20
21This skill teaches the model — the parts an agent gets wrong or can't cheaply
22discover. It does **not** reproduce every flag: for the exact, current flags of
23any command, run mc <command> --help (and mc <command> <subcommand> --help).
24That help is authoritative and version-matched; this skill is not.
25
26## 1. An alias is the prerequisite — nothing works without one
27
28Every remote operation targets an **alias**: a named endpoint + credentials.
29First discover what already exists, then create one only if needed:
30
31```sh
32mc alias list # what's configured (redacts secret keys)
33mc alias list --json # same, machine-readable
34```
35
36Two ways to provide an alias. Prefer the environment form for agents — it keeps
37credentials out of mc's config file and doesn't mutate the user's config:
38
39```sh
40# Per-process — the agent's default. Alias name is the MC_HOST_ suffix.
41# Inject the value from a secret manager / CI secret rather than a literal.
42export MC_HOST_myminio="https://${KEY}:${SECRET}@play.min.io"
43mc ls myminio/ # "myminio" now resolves
44
45# Persisted to ~/.mc/config.json — only when the user wants it saved.
46mc alias set myminio https://play.min.io ACCESS_KEY SECRET_KEY
47```
48
49The env var isn't a free pass on secrecy: a literal export … lands in shell
50history and the value shows in the process environment. Don't hard-code keys or
51echo them into logs. See references/connect.md.
52
53Once set, the alias name is the first path segment (myminio/bucket/key).
54Config lives in ~/.mc/config.json (override with --config-dir or
55MC_CONFIG_DIR). Full details, the token/STS URL form, TLS and other providers:
56**references/connect.md**.
57
58## 2. Get machine-readable output
59
60- **--json emits JSON Lines (NDJSON), not a JSON array.** One JSON object per
61 line — parse line by line (while read, jq -c, streaming), never
62 json.loads() on the whole stream. Streaming commands (ls, mirror, cp)
63 emit one line per item as it happens.
64- Every object has a "status" field ("success" or "error"); on error the
65 object carries the message and mc exits non-zero.
66- --quiet suppresses progress bars/spinners; --no-color drops ANSI. Prefer
67 --json for parsing and add --quiet for clean logs.
68- mc returns exit code 0 on success, non-zero on failure — branch on the
69 exit code, not on stdout text.
70
71Details and per-command shapes: **references/output.md**.
72
73## 3. Path grammar
74
75A target is either a **local path** (./data, /tmp/x) or an
76**alias-qualified S3 path**: ALIAS/BUCKET/PREFIX/OBJECT. The first segment is
77an alias only if it matches a configured alias — otherwise mc treats the whole
78token as a local path. So mc cp file.txt myminio/bucket/ copies local→remote,
79and mc cp myminio/bucket/key ./ copies remote→local. There is no s3://
80scheme; the alias replaces it.
81
82## 4. Destructive operations — refuse and escalate to a human
83
84Some mc commands are **irreversible and/or site-wide**. Treat these as
85**human-only**: do **not** run them yourself, even if the task appears to ask
86for it. Stop, show the user the exact command and target, and require explicit
87human execution or written go-ahead. Never run them speculatively, in a loop,
88or to "tidy up".
89
90**Hard-gated — refuse by default; a human must run them or explicitly authorize:**
91
92- mc rm --recursive --force ALIAS/BUCKET/PREFIX — bulk object deletion.
93 --force is required to recurse. Adding --dangerous to an alias-only target
94 (mc rm --recursive --force --dangerous myminio) wipes an **entire site**.
95 --versions / --purge-deleted destroy version history. **Do not run these.**
96- mc rb --force ALIAS/BUCKET (and mc rb --force --dangerous ALIAS for a whole
97 site) — removes buckets and all their contents. Without --force, rb aborts
98 with a fatal error on a non-empty bucket; it does **not** prompt.
99- mc mirror --remove … — deletes destination objects missing from the source.
100
101**Confirm-first — show the user, proceed only on explicit approval:**
102
103- mc mirror --overwrite …, or cp / put onto an existing key — replaces data.
104- Config-clearing forms: mc ilm rule remove --all --force,
105 mc replicate rm --all --force, mc event remove, mc anonymous set private
106 (revokes public access).
107
108Versioning does not save you unless it was enabled on the bucket beforehand. When
109in doubt, do not act — hand the exact command to a human. See the "irreversible"
110callouts in each reference.
111
112## 5. Command map — pick the right command, then read its --help
113
114| Task | Commands |
115| --- | --- |
116| Connect / configure client | alias, update, license, support |
117| Inspect objects & buckets | ls, stat, head, tree, du, find, diff |
118| Move data | cp, get, put, mv, mirror, pipe, cat, od |
119| Delete data | rm, rb, undo |
120| Query & watch | sql, watch, ping, ready |
121| Share / presign | share |
122| Bucket configuration | mb, version, tag, retention, legalhold, quota, anonymous, cors, encrypt, event |
123| Lifecycle / replication / batch | ilm, replicate, inventory, batch |
124| Cluster administration | admin …, log, qos, kms, idp |
125| AIStor Iceberg Tables | table … |
126
127kms exists both top-level (mc kms) and under admin (mc admin kms) — the
128same server config. For identity providers use the top-level mc idp ldap|openid;
129mc admin idp is **deprecated** and only prints a redirect. log streams/queries
130server logs and qos manages quality-of-service (rate) rules — both
131AIStor-specific. (mc policy is deprecated — use mc anonymous for
132bucket anonymous access.)
133
134## Reference docs
135
136Load these (co-located, under references/) on demand for the task at hand:
137
138- **references/connect.md** — aliases in depth: MC_HOST_ env forms (with
139 session token / STS), mc alias set/list/remove, config file, TLS
140 (--insecure), non-MinIO providers, path-vs-DNS bucket lookup.
141- **references/output.md** — --json NDJSON parsing patterns, exit codes,
142 non-interactive/scripting rules, jq recipes.
143- **references/objects.md** — the data plane: `ls cp mv rm get put mirror find
144 du tree stat head cat pipe od diff sql watch undo share`, with the exact
145 destructive-flag semantics.
146- **references/buckets.md** — bucket lifecycle & configuration: `mb rb version
147 tag retention legalhold quota policy anonymous cors encrypt event`.
148- **references/data-management.md** — ilm (tiering/expiry), replicate
149 (bucket & site replication), inventory, batch jobs.
150- **references/admin.md** — mc admin control plane: server info, users &
151 policies, config, service/heal/scanner, decom/rebalance, KMS, tiers, SUBNET.
152- **references/tables.md** — AIStor Iceberg Tables: warehouses, namespaces,
153 tables, catalog, shares, replication, maintenance.
154
In the file
SKILL.md1,203 words
Files8
LicenceApache-2.0
Why you can read it

Nothing in a skill executes. The client loads the text and the model follows it, so a skill can be audited the way a runbook is — by reading it.

What it costs in context

Skills are not billed by the call. They are paid for in context: every token the instructions occupy is a token your code, your diff and your conversation cannot use. Here is what this one takes and when it takes it.

≈200
always loaded
The name and description, so the model knows the skill exists and when to reach for it.
8,325
on trigger
The instruction body and 7 supporting files, read only when the skill fires.
4.3%
of a 200k window
Ten skills this size would take about 43% of the window before you open a file.
050k100k150k200k context window

8.5k tokens, estimated from the bundle at four bytes to the token, held for the rest of the session once it triggers. Heavy. Teams tend to install this one per project rather than globally, and load it only when the job comes up.

Servers bill, skills cost

A server charges by the month. A skill charges once per session, in context, and then keeps charging it for as long as the session lives.

Before and after

The same question, put to the same model twice: once as it comes, and once with these instructions loaded.

No worked example has been published for this skill yet.

Adoption
Installsnone yet
Ratingno reviews yet

The procedure it runs

The procedure has not been published here. It is in the skill’s own SKILL.md, which its author has not sent to the marketplace yet.

Prose, not code

These steps are written for a model to follow, not executed by a runtime. It can still be told to skip one, and it will say so when it does.

Servers it uses

None. This skill calls no MCP servers at all.

Everything it needs is in the instructions, so it works in a project with nothing connected — the model reads the file and changes how it works with what it can already reach.

It writes no files and reaches no network. All it changes is how the model reasons and writes.

What it asks for
Writes filesno
Network accessno

Read from the allowed-tools line of this skill’s own SKILL.md. A skill grants no permissions of its own — it can only ask for tools your client already has.

What it will not do

Every skill is narrow, and the useful ones say where they stop. These are the jobs this one is the wrong tool for.

What this skill is not for has not been published here. Nothing is implied by that: it is a section the author has not filled in.

What is in the bundle

8 files, 34.1 kB on disk. A bundle is text throughout: the instructions the model reads, plus the templates it fills in.

  • SKILL.md8.2 kB
  • references/admin.md4.0 kB
  • references/buckets.md3.6 kB
  • references/connect.md3.5 kB
  • references/data-management.md3.5 kB
  • references/objects.md4.9 kB
  • references/output.md3.1 kB
  • references/tables.md3.3 kB
What is not in it

No dependencies and nothing executable: a skill is text the agent reads, so the bundle is 8 files you can review in full before installing. The Apache-2.0 licence covers the templates and examples as well as the instructions.

Install

Installing copies the bundle into your project. Nothing runs at install time — the files sit on disk until the model reads them.

$29 once
MinIO Client (mc) · Apache-2.0 · minio
one-time
Price$29 once
LicenceApache-2.0 — the author’s, unchanged by this purchase
Paid throughStripe, once, on the card you add at the checkout
Keeps workingfor good — the files are yours once they are on disk
Updatesevery update its author ships, delivered through this account

You can read the whole bundle before paying — the SKILL.md above is the product, not a preview of it. What the money buys is the delivery: the folder packaged and handed to your machine by key, every update its author ships, and our support if it does not do what this listing says. The terms of use are Apache-2.0, set by the author and unchanged by buying it here.

Payment runs through Stripe, on a page like this one rather than a redirect. Once there is an account it joins the same mcprush invoice as everything else you run, so there is never a second card to enter.

Which clients pick it up on their own

A skill is a folder of text. A client with a skills folder reads it without being told; everywhere else the same text works, it is just handed to the model rather than found.

Claude Code.claude/skills/
Claude Desktop
ChatGPT
Cursor.cursor/skills/
VS Code.github/skills/
Codex CLI.agents/skills/
Gemini CLI.gemini/skills/
Grok.grok/skills/
Zed.agents/skills/
Windsurf.windsurf/skills/
Agent SDK.claude/skills/
HTTP / API
This release
Versionnot versioned
Publishedno release date on file
Price$29
Referenceminio/minio-client-mc

Versions

Its author publishes no version number, so there is nothing here to pin to: what you install is the folder as it stands today. Instructions change more often than APIs do — a skill can be rewritten entirely without anything it depends on moving.

v
  • No earlier releases have been published to the marketplace.
Pinning

Nothing to pin to: this skill carries no version number of its own. What you install is what the folder holds on the day you install it.

Reviews

no reviews yet · no installs yet

Nobody has reviewed this skill yet. The rating is the mean of the reviews written here, so there is none until somebody writes the first.

Who can post

Only accounts that have had the skill installed for fourteen days, so a review is written after living with it rather than after reading it. Publishers may reply once.

Who wrote it

MI
minio

Publishes on mcprush.

0 servers listed1 skill listednot claimed
Profile
Publisher
Servers0