mcp-ipfs

Lists 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.

Generates authentication tokens for using the UCAN-HTTP bridge.

Claims delegated capabilities for the authorized account using a provided proof.

Stores a single file as a blob directly with the service. Requires ABSOLUTE paths for file arguments.

Lists blobs stored in the current space.

Removes a blob from the store by its base58btc encoded multihash.

Gets Filecoin deal information for a given Piece CID (advanced use).

Registers an index CID with the service (advanced use). Please refer to storacha.network documentation for details on indices.

Stores a CAR file with the service (advanced use). This is often a prerequisite for w3_can_upload_add. Requires ABSOLUTE paths for file arguments.

Lists stored CAR files (shards) in the current space (advanced use).

Removes a stored CAR shard by its CID (advanced use). Use with extreme caution, as this deletes the underlying data shard.

Manually registers an upload DAG by its root CID and shard CIDs (advanced use). This is typically used after storing CAR shards manually.

Lists uploads registered in the current space (advanced view, shows underlying structure).

Removes an upload listing by its root CID (advanced use). Does not remove the underlying blobs/shards.

Attempts to create/claim a coupon using a claim code.

Tool for w3_delegation_create operation. Requires ABSOLUTE paths for file arguments.

Tool for w3_delegation_ls operation.

Tool for w3_delegation_revoke operation. Requires ABSOLUTE paths for file arguments.

Generates and prints a new ed25519 key pair. Does not automatically use it for the agent.

Initiates 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.

Tool for w3_ls operation.

Tool for w3_open operation.

Displays the plan associated with the current or specified account.

Tool for w3_proof_add operation. Requires ABSOLUTE paths for file arguments.

Tool for w3_proof_ls operation.

DANGEROUS: Resets the agent state, removing all proofs and delegations but retaining the agent DID. Requires explicit confirmation argument.

Tool for w3_rm operation.

Tool for w3_space_add operation.

Creates 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.

Tool 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.

Tool 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.

Associates a space with a customer/billing account.

Tool for w3_space_use operation.

Generates and prints a new ed25519 key pair. Does not automatically use it for the agent. Requires ABSOLUTE paths for file arguments.

Displays a storage usage report for the current or specified space.