Skip to main content
Glama

Handoff: Send Files to Users & Agents

Server Details

Send a file to a user or agent as a share link with expiry, max opens, approval, revoke and logs.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
jueluddinsf/handoff-mcp
GitHub Stars
0
Server Listing
Handoff
ChatGPT
–
Claude
–

TDQS

A4.1/5.0

Scored across 14 tools

Disambiguation5/5

The tools cover distinct file, share, and access-control actions with little overlap. Potential confusion between share_file, create_share_link, and save_file is resolved by descriptions: one-call share, link for existing file, and private save respectively.

Naming Consistency4/5

Most tools follow a clear snake_case verb_noun pattern such as create_share_link, get_share_status, list_files, and revoke_share. The main deviation is signup, which is a single-word tool name rather than verb_noun, but overall the naming is predictable.

Tool Count5/5

With 14 tools, the surface is well-scoped for a file-sharing service. Each tool corresponds to a meaningful operation across file storage, sharing, approval, revocation, and access logging.

Completeness4/5

The core lifecycle is well covered: save/list/delete files, create/list/status/update/revoke shares, approve/deny grants, fetch shared files, and inspect access logs. Minor gaps remain, such as no direct get/update file-content operation and no tool to modify share audience or max_opens after creation.

Available Tools

14 tools
approve_shareApprove a shareA
Idempotent
Inspect

Approve an owned grant that was created with requires_approval. Opens stay blocked until this succeeds. Requires your API key.

Inputs: grant_id (required), api_key.

delete_fileDelete a fileA
Destructive
Inspect

Delete a file you own. The bytes are removed and existing share links stop working. Requires your API key.

Inputs: file_id (required), api_key. Returns: deleted, file_id

deny_shareDeny a shareA
DestructiveIdempotent
Inspect

Deny an owned grant. A denied grant stays blocked. Requires your API key.

Inputs: grant_id (required), api_key.

fetch_shared_fileFetch a shared fileA
Read-only
Inspect

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.

Inputs: url_or_token (required), api_key.

get_access_logGet access logA
Read-onlyIdempotent
Inspect

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.

Inputs: grant_id (required), api_key.

get_share_statusGet share statusA
Read-onlyIdempotent
Inspect

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.

Inputs: grant_id (required), api_key.

list_filesList filesA
Read-onlyIdempotent
Inspect

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.

Inputs: api_key.

list_sharesList sharesA
Read-onlyIdempotent
Inspect

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.

Inputs: api_key, file_id.

revoke_shareRevoke a shareA
DestructiveIdempotent
Inspect

Permanently revoke an owned share. Later downloads fail. This cannot be undone and does not delete the file. Requires your API key.

Inputs: grant_id (required), api_key.

save_fileSave a fileAInspect

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.

Inputs: name (required), mime, api_key, content_text, +1 more.

share_fileShare a fileAInspect

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.

Inputs: name (required), ref, mime, api_key, +7 more. Returns: url, next, api_key, file_id, +5 more

signupCreate an accountAInspect

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.

Inputs: ref, agent_id. Returns: caps, next, api_key, agent_id, +1 more

update_shareUpdate share expiryAInspect

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.

Inputs: grant_id (required), expires_in_hours (required), api_key. Returns: status, file_id, audience, grant_id, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables agents to price, send, and track encrypted file transfers, with files chunked, encrypted, and hashed locally before any network relay, and to retrieve signed collection receipts. It supports prepaid credit pools and gives agents a privacy-first transfer capability within their own trust domain.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to securely transfer files between machines via encrypted, expiring share links, with tools for upload, download, status checks, and link management.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Secure file exchange MCP server enabling AI agents to upload, share, fetch, and revoke files with SHA-256 verification, malware scanning, expiry, access restrictions, and human approval workflows.
      47 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.