Fileshareforagents

online.fileshareforagents由 fileshareforagents.online 发布v0.2.0更新于 Nov 3, 2026

Storage for AI agents: free public items, or private items paid with credits or USDC (x402).

已验证STDIO仅桌面文件与存储商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手通过 fileshareforagents.online 存储、分享和取回文件与文本，公开条目免费，付费调用按次计费。

可以做什么
  • 以文本、JSON、base64 字节或本地文件形式存储内容：公开条目最长 7 天，私有条目 1 至 365 天
  • 取回已存内容（内联返回或保存到文件），并查看到期时间、剩余读取次数、大小和类型
  • 延长保留期限、加购读取次数，以及永久删除条目
  • 生成限时签名分享链接、撤销链接，并为公开地址设置或移除密码
  • 查询价格、钱包余额和账户额度，用 USDC 购买额度，以及提交反馈
适用场景
适合助手需要把文件或片段交给某个人或另一个助手，或把内容临时存放几天以便访问，而不想自建存储的场景。也适合需要简单付费暂存箱、按额度或 USDC 结算的助手。
运行要求
通过 stdio 在本地运行，通常用 npx 启动，需要 Node.js。付费工具需要账户 API 密钥（FILESHARE_API_KEY）或持有 USDC 的钱包私钥（WALLET_KEY）；免费工具无需二者。FILESHARE_NETWORK 选择 testnet（默认，Base Sepolia）或 mainnet（Base）。需要能访问该服务的网络。
安装前请注意
付费工具会花钱：每次调用消耗一个预付额度或 0.01 USDC，buy_credits 会扣 USDC。WALLET_KEY 是持有资金钱包的私钥，建议先在 testnet 试用。内容到期即删除且无法恢复，store 返回的一次性 secret 决定条目控制权。分享链接本身就是凭证，持有者即可打开；delete 为永久删除且不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Fileshareforagents，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

fileshareforagents-mcp

MCP server for fileshareforagents.online: storage and file sharing for AI agents. Public items (up to 7 days) are free. Private items, longer retention, extensions and read packs are paid calls, one cent each, and there are two ways to pay:

  • Prepaid credits, no wallet. Sign in at https://fileshareforagents.online/login, buy credits (10 are included on signup), create an API key in the dashboard and set it as FILESHARE_API_KEY. Each paid call spends one credit.
  • USDC over x402. Set WALLET_KEY to a wallet holding USDC on Base; the server signs a $0.01 payment per call. The key never leaves the process and is never sent to the service. With both configured, credits are used first and the wallet steps in when they run out.

The server runs locally next to your agent (stdio).

Install

Claude Desktop, Claude Code, Cursor, Windsurf and most MCP clients take a config like this:

json
{  "mcpServers": {    "fileshare": {      "command": "npx",      "args": ["-y", "fileshareforagents-mcp"],      "env": {        "FILESHARE_API_KEY": "fsa_<key from the dashboard>",        "FILESHARE_NETWORK": "mainnet"      }    }  }}

Claude Code, one line:

claude mcp add fileshare -e FILESHARE_API_KEY=fsa_... -e FILESHARE_NETWORK=mainnet -- npx -y fileshareforagents-mcp

Paying with a wallet instead: replace FILESHARE_API_KEY with WALLET_KEY=0x... (a private key of a wallet holding USDC on the chosen network).

Start on testnet (the default): free test USDC on Base Sepolia from faucet.circle.com, nothing real at stake. Switch to real money with FILESHARE_NETWORK=mainnet and a wallet holding USDC on Base. The wallet needs no ETH; the payment facilitator pays gas.

Without WALLET_KEY the free tools work and the paid ones explain what to set.

Tools

ToolCostWhat it does
store_publicfreePublic item for up to 7 days: text, JSON, base64 bytes or a local file. Anyone with links.public can open it.
store1¢Private item for 1 to 365 days: text, JSON, base64 bytes or a local file (file_path). Includes 100 reads. Returns id and a one-time secret.
retrievefree (1 read)Get the content back. Text and JSON inline, binary as base64 or saved to save_to.
statusfreeExpiry, reads left, size, type, password flag.
extend1¢New expiry, up to 365 days from now.
buy_reads1¢Add 1000 reads. No secret needed, so anyone can top up an item they were given.
share_linkfreeSigned, time-limited URL anyone can open, no password asked. The URL is the credential.
revoke_linksfreeInvalidate every share link issued so far.
set_passwordfreeProtect the item's public address with a password (12 to 128 chars). Browsers get a form, agents send x-password.
remove_passwordfreePublic address stops serving; signed links still work.
deletefreePermanent, no refund.
pricingfreePrices, limits, allowed content types, network.
wallet_statusfreeAddress and USDC balance of the paying wallet, and how to fund it.
accountfreeCredits, files and storage of the account behind FILESHARE_API_KEY.
buy_creditsN¢Buy N credits for that account with one USDC payment (needs both the key and a wallet).
feedbackfreeMissing feature, bug, or abuse report, straight to the operator.

Allowed content: JSON, text, Markdown, CSV, HTML, SVG, PDF, PNG, JPEG, WebP, GIF, up to 25 MB.

Two ways to hand content to a human

  1. share_link with expires_in seconds. Send the URL. Nothing else needed, but anyone holding the URL can read until it expires.
  2. set_password, then send the returned public_url and the password over different channels. The address asks for the password on every open.

Each open counts one read; buy_reads first if many people will open it.

Environment

VariableDefaultMeaning
FILESHARE_API_KEYunsetfsa_… account key from the dashboard. Paid tools spend one credit per call; no wallet needed.
WALLET_KEYunset0x + 64 hex chars. Paid tools pay $0.01 USDC per call over x402.
FILESHARE_NETWORKtestnettestnet (Base Sepolia) or mainnet (Base).
FILESHARE_APIper networkOverride the API origin.
FILESHARE_SHAREper networkOverride the share-domain origin.

Notes

  • Content is deleted at expiry and cannot be recovered. This is a drop box, not a vault.
  • Keep the secret from store; it is shown once. Whoever has it controls the item.
  • Terms of service: https://fileshareforagents.online/terms. Machine-readable docs: https://fileshareforagents.online/llms.txt.
  • Failed settlements are never charged; the server retries once and otherwise returns the service's error with a request_id you can quote in feedback.

MIT licensed.

来源：mcp/README.md，提交 d6b0516

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

2
  1. v0.2.0最新Sep 29, 2026
  2. v0.1.2Sep 18, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分