Tools reference
All 8 MCP tools exposed by @ipfs-meshkit/mcp with input and output schemas.
ipfs_upload
Upload text or base64-encoded binary content to IPFS. Returns the CID.
Input (one of):
{ "content": "Hello, IPFS!" }{ "base64": "aGVsbG8=" }Output: CID string, e.g. "Qm..."
ipfs_retrieve
Retrieve content from IPFS by CID.
Input:
{ "cid": "Qm..." }Output: Content as text (UTF-8), or base64 for binary.
ipfs_pin
Pin a CID on the node to prevent garbage collection.
Input:
{ "cid": "Qm..." }Output: Confirmation message.
ipfs_list_pins
List all pinned CIDs on the primary node.
Input: None
Output: Array of CID strings.
ipfs_publish_name
Publish an IPNS record pointing at a CID or /ipfs/... path.
Input:
{
"value": "Qm...",
"key": "latest",
"ttl": "1m",
"lifetime": "24h"
}| Field | Required | Description |
|---|---|---|
value | Yes | CID or /ipfs/... path to publish. |
key | No | Keystore label. Defaults to "self". |
ttl | No | Cache hint for resolvers. |
lifetime | No | Record validity window. |
Output: IPNS name and published path.
ipfs_resolve
Resolve an IPNS name and retrieve the content bytes.
Input:
{ "name": "/ipns/Qm..." }Output: Resolved content as text or base64.
ipfs_generate_key
Create a named IPNS signing key in the node's keystore.
Input:
{ "name": "my-key" }Output: Key ID (stable IPNS name) and key name.
ipfs_list_keys
List all IPNS keys in the node's keystore.
Input: None
Output: Array of { id, name } objects.