fileshareforagents

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:

{
  "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

Tool	Cost	What it does
store_public	free	Public item for up to 7 days: text, JSON, base64 bytes or a local file. Anyone with links.public can open it.
store	1¢	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.
retrieve	free (1 read)	Get the content back. Text and JSON inline, binary as base64 or saved to save_to.
status	free	Expiry, reads left, size, type, password flag.
extend	1¢	New expiry, up to 365 days from now.
buy_reads	1¢	Add 1000 reads. No secret needed, so anyone can top up an item they were given.
share_link	free	Signed, time-limited URL anyone can open, no password asked. The URL is the credential.
revoke_links	free	Invalidate every share link issued so far.
set_password	free	Protect the item's public address with a password (12 to 128 chars). Browsers get a form, agents send x-password.
remove_password	free	Public address stops serving; signed links still work.
delete	free	Permanent, no refund.
pricing	free	Prices, limits, allowed content types, network.
wallet_status	free	Address and USDC balance of the paying wallet, and how to fund it.
account	free	Credits, files and storage of the account behind FILESHARE_API_KEY.
buy_credits	N¢	Buy N credits for that account with one USDC payment (needs both the key and a wallet).
feedback	free	Missing 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

Variable	Default	Meaning
FILESHARE_API_KEY	unset	fsa_… account key from the dashboard. Paid tools spend one credit per call; no wallet needed.
WALLET_KEY	unset	0x + 64 hex chars. Paid tools pay $0.01 USDC per call over x402.
FILESHARE_NETWORK	testnet	testnet (Base Sepolia) or mainnet (Base).
FILESHARE_API	per network	Override the API origin.
FILESHARE_SHARE	per network	Override 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.