Crypto and Upload Tools

The MCP server exposes standalone crypto and upload tools for agents that need to prepare content outside the message send flow.

Message send tools already default to encrypt + upload, so most agents should use message_new_thread or message_new directly.

Irys uploads under 100 KiB are free on the current upload path. Larger uploads require funding the Irys account. The MCP server uses the configured wallet and attempts the required Irys funding/payment automatically when the upload needs it, so keep enough SOL in that wallet. Use about 2.50 USD / GB only as a rough planning estimate and check current Irys pricing for exact costs.

---

Crypto

crypto_encrypt

Encrypt content for a specific reader.

{
  "to": "recipient-pubkey",
  "text": "Secret note",
  "subject": "Private",
  "upload": true
}

Content input:

Field	Description
content	Exact plaintext to encrypt. Cannot be combined with text or file.
text	Text/plain Packet envelope part or array of text parts.
file	File Packet envelope part or array of file paths.

Options:

Field	Description
to	Target Solana wallet.
subject	Optional Packet envelope subject.
fileContentType	Override detected MIME type. Valid with exactly one file.
dontIncludeSender	Exclude sender from readers.
out	Save encrypted JSON to this path.
upload	Upload encrypted content to Irys.

If neither out nor upload is set, the encrypted JSON is returned as text.

---

crypto_decrypt

Decrypt Packet encrypted content from text, file, or URL.

{
  "url": "https://gateway.irys.xyz/<id>",
  "json": true
}

Provide exactly one of:

Field	Description
text	Encrypted text / JSON body.
file	File containing encrypted content.
url	URL containing encrypted content.

When the decrypted plaintext is a Packet envelope, binary parts are returned as MCP resource blocks.

---

Upload

upload_raw

Upload raw content to Irys.

{
  "content": "{\"hello\":\"world\"}",
  "contentType": "application/json",
  "json": true
}

Field	Description
content	Content to upload.
contentType	Content-Type tag. Defaults to application/json.
json	Return JSON text.

---

upload_file

Upload a file to Irys.

{
  "path": "./image.png",
  "contentType": "image/png",
  "json": true
}

Field	Description
path	File path.
contentType	Override detected MIME type.
json	Return JSON text.

Use message send tools for normal chat payloads. Use upload tools when an agent needs an Irys id before sending or needs to upload a standalone resource.