MCP SERVERDrive the w3 command line against storacha.network from the client: authorize the agent by email, upload from absolute paths, issue and revoke delegations, and read what each space is using.
LABSCO SUMMARY
The tool list goes deeper than upload-and-list: blobs, CAR shards and upload DAGs are each addressable, so removing an upload listing and removing the bytes under it are separate decisions — w3_can_upload_rm states outright that it leaves the blobs and shards in place. Worth planning around: agent state can be ephemeral, in Docker for instance, so authorization needs re-checking after a reconnect, and w3_reset drops every proof and delegation behind an explicit confirmation argument.
A wrapper over the w3 command line for storacha.network, with 35 tools covering login, spaces, uploads, delegations and the blob and CAR layer beneath them.
W3_LOGIN_EMAIL, a storacha.network account, and access to that mailbox — w3_login waits on an email confirmation that has to be clicked before the other tools work. A space also has to exist already: w3_space_create cannot run through MCP because of its interactive recovery-key prompt, so it is created in a terminal first. Files live on the machine running the server and are addressed by absolute path.
One command — npx -y mcp-ipfs
USE CASES
Start the login, tell the user in no uncertain terms to click the confirmation email, then check the agent is linked and point it at the space you mean to work in.
Upload the directory by absolute path, confirm it landed in the space, and open it by CID to check what was actually stored.
Issue a delegation to their DID with only the capabilities they need, keep track of what is outstanding, and revoke it when the work is finished; on their side the proof is claimed before it takes effect.
Remove the upload listing, then decide separately about the data: list the blobs still in the space and remove the ones nothing else points at.
Read the usage report for the space, check which plan the account is on, and look at the CAR shards underneath if the number is larger than the upload list suggests.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
w3_account_lsLists all accounts the current agent is authorized for. Use this command after w3_login and email validation to confirm the agent is successfully linked to your storacha.network account(s). Note: Agent state may be ephemeral (e.g., in Docker). Check authorization status with this command after (re)connecting, and use w3_login if needed.
w3_bridge_generate_tokensGenerates authentication tokens for using the UCAN-HTTP bridge.
w3_can_access_claimClaims delegated capabilities for the authorized account using a provided proof.
w3_can_blob_addStores a single file as a blob directly with the service. Requires ABSOLUTE paths for file arguments.
w3_can_blob_lsLists blobs stored in the current space.
w3_can_blob_rmRemoves a blob from the store by its base58btc encoded multihash.
w3_can_filecoin_infoGets Filecoin deal information for a given Piece CID (advanced use).
w3_can_index_addRegisters an index CID with the service (advanced use). Please refer to storacha.network documentation for details on indices.
w3_can_store_addStores a CAR file with the service (advanced use). This is often a prerequisite for w3_can_upload_add. Requires ABSOLUTE paths for file arguments.
w3_can_store_lsLists stored CAR files (shards) in the current space (advanced use).
w3_can_store_rmRemoves a stored CAR shard by its CID (advanced use). Use with extreme caution, as this deletes the underlying data shard.
w3_can_upload_addManually registers an upload DAG by its root CID and shard CIDs (advanced use). This is typically used after storing CAR shards manually.
w3_can_upload_lsLists uploads registered in the current space (advanced view, shows underlying structure).
w3_can_upload_rmRemoves an upload listing by its root CID (advanced use). Does not remove the underlying blobs/shards.
w3_coupon_createAttempts to create/claim a coupon using a claim code.
w3_delegation_createTool for w3_delegation_create operation. Requires ABSOLUTE paths for file arguments.
w3_delegation_lsTool for w3_delegation_ls operation.
w3_delegation_revokeTool for w3_delegation_revoke operation. Requires ABSOLUTE paths for file arguments.
w3_key_createGenerates and prints a new ed25519 key pair. Does not automatically use it for the agent.
w3_loginInitiates the w3 login process using the pre-configured email (W3_LOGIN_EMAIL env var). IMPORTANT: The command expects email confirmation, so before running the w3_login tool, emphasize ATTENTION to the user in large letters + emoji that they MUST check email to complete authentication. If the final output includes 'Agent was authorized by', the user has already clicked the link and is successfully authorized, CONTINUE using mcp-ipfs tools. 'Too Many Requests': wait a moment before requesting it again.
w3_lsTool for w3_ls operation.
w3_openTool for w3_open operation.
w3_plan_getDisplays the plan associated with the current or specified account.
w3_proof_addTool for w3_proof_add operation. Requires ABSOLUTE paths for file arguments.
w3_proof_lsTool for w3_proof_ls operation.
w3_resetDANGEROUS: Resets the agent state, removing all proofs and delegations but retaining the agent DID. Requires explicit confirmation argument.
w3_rmTool for w3_rm operation.
w3_space_addTool for w3_space_add operation.
w3_space_createCreates a new space with a user-friendly name. NOTE: w3 space create cannot be run via MCP due to interactive recovery key prompts. Please run this command manually in your terminal.
w3_space_infoTool for w3_space_info operation. NOTE: no current space and no space given or {"spaces":[]} first make sure you are logged in before using other tools.
w3_space_lsTool for w3_space_ls operation. NOTE: no current space and no space given or {"spaces":[]} first make sure you are logged in before using other tools.
w3_space_provisionAssociates a space with a customer/billing account.
w3_space_useTool for w3_space_use operation.
w3_upGenerates and prints a new ed25519 key pair. Does not automatically use it for the agent. Requires ABSOLUTE paths for file arguments.
w3_usage_reportDisplays a storage usage report for the current or specified space.
BEFORE YOU INSTALL
35 tools when we connected.
CONTEXT COST
Rated by the size of the 35 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Add the block to your client, or run the command directly.
{
"mcpServers": {
"ipfs": {
"command": "npx",
"args": [
"-y",
"mcp-ipfs"
],
"env": {
"W3_LOGIN_EMAIL": "<YOUR_W3_LOGIN_EMAIL>"
}
}
}
}npx -y mcp-ipfsMCP servers
aashari
runjivu
sibilleb
IcyKallen