{"id":"io.github.jueluddinsf/handoff","slug":"io-github-jueluddinsf-handoff","title":"Handoff: Send Files to Users & Agents","description":"Send a file to a user or agent as a share link with expiry, max opens, approval, revoke and logs.","version":"1.0.1","publisher":{"kind":"github","id":"jueluddinsf","label":"@jueluddinsf on GitHub","url":"https://github.com/jueluddinsf"},"website":"https://hand-off.space","repository":"https://github.com/jueluddinsf/handoff-mcp","remotes":[{"type":"streamable-http","url":"https://hand-off.space/mcp","headers":[{"description":"API key from signup. Send Authorization: Bearer and the hf_ key, or the bare key. Not required to connect or list tools.","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-29","updated":"2026-10-29","status":"online","auth":"","latency_ms":1269,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"share_file","title":"Share a file","description":"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.","read_only":false},{"name":"signup","title":"Create an account","description":"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.","read_only":false},{"name":"save_file","title":"Save a file","description":"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.","read_only":false},{"name":"list_files","title":"List files","description":"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.","read_only":true},{"name":"create_share_link","title":"Create a share link","description":"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, plus expires_at and max_opens. Save the url immediately. Later status calls do not return it. When expires_in_hours is omitted, the link expires in 7 days. Download with GET on that url. Requires your API key.","read_only":false},{"name":"get_share_status","title":"Get share status","description":"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.","read_only":true},{"name":"approve_share","title":"Approve a share","description":"Approve an owned grant that was created with requires_approval. Opens stay blocked until this succeeds. Requires your API key.","read_only":false},{"name":"deny_share","title":"Deny a share","description":"Deny an owned grant. A denied grant stays blocked. Requires your API key.","read_only":false},{"name":"revoke_share","title":"Revoke a share","description":"Permanently revoke an owned share. Later downloads fail. This cannot be undone and does not delete the file. Requires your API key.","read_only":false},{"name":"get_access_log","title":"Get access log","description":"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.","read_only":true},{"name":"fetch_shared_file","title":"Fetch a shared file","description":"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 t","read_only":true},{"name":"delete_file","title":"Delete a file","description":"Delete a file you own. The bytes are removed and existing share links stop working. Requires your API key.","read_only":false},{"name":"list_shares","title":"List shares","description":"List grants you own. Pass file_id to limit the list to one file. Returns grant_id, status, open_count, max_opens, expires_at, and audience. Does not return tokens or download urls. Requires your API key.","read_only":true},{"name":"update_share","title":"Update share expiry","description":"Set when an owned share expires. expires_in_hours is measured from now. Example: 168 for 7 days. Does not return the token. Requires your API key.","read_only":false}],"server_info":{"name":"io.github.jueluddinsf/handoff","title":"Handoff: Send Files to Users & Agents","version":"1.0.1","description":"Send a file to a user or agent as a share link with expiry, max opens, approval, revoke and logs."},"category":"productivity","tags":["agents","cloud"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-29","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-jueluddinsf-handoff/"}