a4a_open_file
Verify and decrypt a local blob or fetch an attachment from this mailbox's gateway, then write it to a safe output path without overwriting existing files. Returns the written path, size, and sender, or a refusal reason.
Instructions
Verify and decrypt a local blob, or save an attachment from this mailbox's gateway.
File-reference locations and metadata are never shown to the model. With `blob_path`
this opens an existing local blob supplied by the owner or trusted host outside MCP;
it matches a hidden incoming reference and makes no network request for the blob.
With `attachment` the blob comes only from this mailbox's own file gateway, fetched
as the recipient; references to any other location are never followed.
Args:
blob_path: Existing local blob path. Give this or `attachment`, not both.
attachment: The handle shown in an "[A4A attachment]" message. The blob is
taken only from a file gateway configured for this mailbox
(A4A_FILE_GATEWAY), as the recipient; nothing is opened or run.
out_path: Decrypted output path; existing files are never overwritten.
since_days: How many days of incoming history to search; default 30.
Returns:
Written path, size, and sender, or a refusal reason.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "a4a_open_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| out_path | No | ||
| blob_path | No | ||
| attachment | No | ||
| since_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |