M
Meshkit

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"
}
FieldRequiredDescription
valueYesCID or /ipfs/... path to publish.
keyNoKeystore label. Defaults to "self".
ttlNoCache hint for resolvers.
lifetimeNoRecord 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.

On this page