Send a file to a user or agent as a share link with expiry, max opens, approval, revoke and logs.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
API key from signup. Send Authorization: Bearer and the hf_ key, or the bare key. Not required to connect or list tools.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Approve an owned grant that was created with requires_approval. Opens stay blocked until this succeeds. Requires your API key.
grant_id returned when the share was created.
Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Tool list last changed Oct 29, 2026.
Approve an owned grant that was created with requires_approval. Opens stay blocked until this succeeds. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| grant_id* | string | grant_id returned when the share was created. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grant_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"grant_id": {
"type": "string",
"description": "grant_id returned when the share was created."
}
},
"additionalProperties": false
}Create a controlled download link for a file you own. Use this when a person or another agent should fetch the file. The response includes url and token ONCE. Save the url immediately. Later status calls do not return it. Download with GET on that url. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| file_id* | string | File id returned by save_file or list_files. |
| audience* | string | anyone_with_link: whoever has the saved url. agent: only the registered agent_id in audience_value. |
| max_opens | integer | Successful downloads allowed. The next one is refused. |
| audience_value | string | Required for agent: the recipient's registered agent_id. |
| expires_in_hours | number | Stop serving the file after this many hours. |
| requires_approval | boolean | When true, downloads wait until the owner approves the grant. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"file_id",
"audience"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"file_id": {
"type": "string",
"description": "File id returned by save_file or list_files."
},
"audience": {
"enum": [
"anyone_with_link",
"agent"
],
"type": "string",
"description": "anyone_with_link: whoever has the saved url. agent: only the registered agent_id in audience_value."
},
"max_opens": {
"type": "integer",
"maximum": 2147483647,
"description": "Successful downloads allowed. The next one is refused.",
"exclusiveMinimum": 0
},
"audience_value": {
"type": "string",
"maxLength": 320,
"description": "Required for agent: the recipient's registered agent_id."
},
"expires_in_hours": {
"type": "number",
"maximum": 87600,
"description": "Stop serving the file after this many hours.",
"exclusiveMinimum": 0
},
"requires_approval": {
"type": "boolean",
"default": false,
"description": "When true, downloads wait until the owner approves the grant."
}
},
"additionalProperties": false
}Deny an owned grant. A denied grant stays blocked. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| grant_id* | string | grant_id of the share to deny. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grant_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"grant_id": {
"type": "string",
"description": "grant_id of the share to deny."
}
},
"additionalProperties": false
}Download a file from a share url or token. Use this when you were given a Handoff url and need the bytes. Honors expiry, open limits, approval, and agent audience. anyone_with_link needs no key. An agent audience uses your API key. Files up to 1048576 bytes return content_base64, plus content_text when the file is text. Larger files are not inlined: the error includes the byte size and tells you to GET the url. A successful inline return counts as an open. A file over the inline limit does not.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| url_or_token* | string | Share url returned by create_share_link, or the 64-character token. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url_or_token"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"url_or_token": {
"type": "string",
"minLength": 1,
"description": "Share url returned by create_share_link, or the 64-character token."
}
},
"additionalProperties": false
}Read the latest 1000 access attempts for an owned grant, including refused downloads. Use this to see whether a share was opened. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| grant_id* | string | grant_id of the share to audit. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grant_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"grant_id": {
"type": "string",
"description": "grant_id of the share to audit."
}
},
"additionalProperties": false
}Read an owned grant: token_prefix (not the secret), audience, approval, expiry, revocation, and open_count. Does not download the file and does not return the share URL. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| grant_id* | string | grant_id returned when the share was created. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grant_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"grant_id": {
"type": "string",
"description": "grant_id returned when the share was created."
}
},
"additionalProperties": false
}List this account's files, newest first, up to 1000. Use this to find a file_id before sharing. Returns metadata only, never bytes or download URLs. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
}
},
"additionalProperties": false
}Permanently revoke an owned share. Later downloads fail. This cannot be undone and does not delete the file. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| grant_id* | string | grant_id of the share to revoke. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"grant_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"grant_id": {
"type": "string",
"description": "grant_id of the share to revoke."
}
},
"additionalProperties": false
}Save a private file for this account. Pass name and content_text or content_base64. Returns the file id and metadata. Does not share the file. Requires your API key.
| Argument | Type | Description |
|---|---|---|
| mime | string | MIME type. Inferred from the file name when omitted. |
| name* | string | File name with an extension. No slashes or control characters. |
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| content_text | string | UTF-8 text. Pass exactly one of content_text or content_base64. |
| content_base64 | string | Standard base64 file bytes. Do not include a data: URL prefix. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"mime": {
"type": "string",
"pattern": "^[\\w.+-]+\\/[\\w.+-]+$",
"maxLength": 200,
"description": "MIME type. Inferred from the file name when omitted."
},
"name": {
"type": "string",
"pattern": "^[^/\\\\\\x00-\\x1f]+$",
"maxLength": 255,
"minLength": 1,
"description": "File name with an extension. No slashes or control characters."
},
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"content_text": {
"type": "string",
"maxLength": 70000000,
"description": "UTF-8 text. Pass exactly one of content_text or content_base64."
},
"content_base64": {
"type": "string",
"maxLength": 70000000,
"description": "Standard base64 file bytes. Do not include a data: URL prefix."
}
},
"additionalProperties": false
}Share a file in one call and get a download link. Pass name and content_text (or content_base64). Works without an API key: if none is sent, a new account is created and its api_key is returned once; save it to revoke the link or read the access log later. Default link: anyone with the link, expires in 7 days.
| Argument | Type | Description |
|---|---|---|
| ref | string | Optional attribution label. Lowercase letters, digits, dot, underscore, or hyphen. At most 64 characters. |
| mime | string | MIME type. Inferred from the file name when omitted. |
| name* | string | File name with an extension. No slashes or control characters. |
| api_key | string | Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share. |
| audience | string | Default anyone_with_link. |
| max_opens | integer | Successful downloads allowed. Omit for no limit. |
| content_text | string | UTF-8 text. Pass exactly one of content_text or content_base64. |
| audience_value | string | Required when audience is agent. |
Create a Handoff account and return an API key once. No Authorization header is required. Save api_key. On later calls send Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass api_key only if you cannot set headers. share_file can create this key for you. The key is a secret. Do not put it in a file you share.
| Argument | Type | Description |
|---|---|---|
| ref | string | Optional attribution label. Lowercase letters, digits, dot, underscore, or hyphen. At most 64 characters. |
| agent_id | string | Optional label, unique across Handoff. Letters, numbers, underscore, and hyphen. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ref": {
"type": "string",
"pattern": "^[a-z0-9._-]+$",
"maxLength": 64,
"minLength": 1,
"description": "Optional attribution label. Lowercase letters, digits, dot, underscore, or hyphen. At most 64 characters."
},
"agent_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 80,
"minLength": 1,
"description": "Optional label, unique across Handoff. Letters, numbers, underscore, and hyphen."
}
},
"additionalProperties": false
}| content_base64 | string | Standard base64 file bytes. Do not include a data: URL prefix. |
| expires_in_hours | number | Hours until the link expires. Default 168 (7 days). |
| requires_approval | boolean | Default false. When true, downloads wait until the owner approves. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"ref": {
"type": "string",
"pattern": "^[a-z0-9._-]+$",
"maxLength": 64,
"minLength": 1,
"description": "Optional attribution label. Lowercase letters, digits, dot, underscore, or hyphen. At most 64 characters."
},
"mime": {
"type": "string",
"pattern": "^[\\w.+-]+\\/[\\w.+-]+$",
"maxLength": 200,
"description": "MIME type. Inferred from the file name when omitted."
},
"name": {
"type": "string",
"pattern": "^[^/\\\\\\x00-\\x1f]+$",
"maxLength": 255,
"minLength": 1,
"description": "File name with an extension. No slashes or control characters."
},
"api_key": {
"type": "string",
"minLength": 1,
"description": "Secret API key from signup. Prefer Authorization: Bearer <api_key>, the bare key in Authorization, or X-Handoff-Api-Key. Pass this only when you cannot set headers. Do not write it into a file you share."
},
"audience": {
"enum": [
"anyone_with_link",
"agent"
],
"type": "string",
"description": "Default anyone_with_link."
},
"max_opens": {
"type": "integer",
"maximum": 2147483647,
"description": "Successful downloads allowed. Omit for no limit.",
"exclusiveMinimum": 0
},
"content_text": {
"type": "string",
"maxLength": 70000000,
"description": "UTF-8 text. Pass exactly one of content_text or content_base64."
},
"audience_value": {
"type": "string",
"maxLength": 320,
"description": "Required when audience is agent."
},
"content_base64": {
"type": "string",
"maxLength": 70000000,
"description": "Standard base64 file bytes. Do not include a data: URL prefix."
},
"expires_in_hours": {
"type": "number",
"maximum": 87600,
"description": "Hours until the link expires. Default 168 (7 days).",
"exclusiveMinimum": 0
},
"requires_approval": {
"type": "boolean",
"description": "Default false. When true, downloads wait until the owner approves."
}
},
"additionalProperties": false
}