Fileshareforagents

online.fileshareforagentsPublished by fileshareforagents.onlinev0.2.0Updated Nov 3, 2026

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

VerifiedSTDIODesktop onlyFiles & StorageBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant store, share and retrieve files and text through fileshareforagents.online, free for public items or paid per call.

What you can do
  • Store content publicly for up to 7 days, or privately for 1 to 365 days, as text, JSON, base64 bytes or a local file
  • Retrieve stored items inline or saved to a file, and check expiry, reads left, size and type
  • Extend retention, buy extra reads, and delete items permanently
  • Create signed time-limited share links, revoke them, and set or remove a password on the public address
  • Check pricing, wallet balance and account credits, buy credits with USDC, and send feedback
When to use it
Useful when an assistant needs to hand a file or snippet to a human or another agent, or park content somewhere reachable for a few days, without setting up its own storage. Also fits agents that need a simple paid drop box with credit or USDC billing.
Requirements
Runs locally over stdio, typically via npx with Node.js. An account API key in FILESHARE_API_KEY, or a wallet private key in WALLET_KEY holding USDC, is needed for paid tools; free tools work without either. FILESHARE_NETWORK selects testnet (default, Base Sepolia) or mainnet (Base). Network access to the service is required.
Before you install
Paid tools spend money: one prepaid credit or $0.01 USDC per call, and buy_credits charges USDC. WALLET_KEY is a private key for a funded wallet; use testnet first. Stored content is deleted at expiry and cannot be recovered, and the one-time secret from store controls the item. Share links are credentials anyone holding them can open, and delete is permanent with no refund.

Installation

In SourceWeft

  1. Open Fileshareforagents in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: mcp/README.md at commit d6b0516

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.0LatestSep 29, 2026
  2. v0.1.2Sep 18, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts