
Fileshareforagents MCP server
online.fileshareforagents/mcp·v0.2.0Storage for AI agents: free public items, or private items paid with credits or USDC (x402).
0 stars
Reviews
Write oneNobody has reviewed Fileshareforagents yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Fileshareforagents tools (16, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
accountThe account behind FILESHARE_API_KEY: credits left, files, storage used. Free. Says how to get a key when none is configured.
buy_creditswrite actionBuy N credits for the account behind FILESHARE_API_KEY with one USDC payment of N cents from WALLET_KEY (both must be configured). 1 credit = 1 paid call.
buy_readswrite actionAdd 1000 reads to an item. Costs $0.01 USDC. No secret needed, so anyone can top up an item they were given. Do this before sharing with many readers.
deletewrite actionDelete the item now. Permanent, no refund. Free.
extendSet a new expiry, ttl_days from now (1 to 365; must be later than the current expiry). Costs $0.01 USDC.
feedbackwrite actionSend feedback to the service operator: a missing feature, a bug, an abuse report about an item, or anything else. Free.
pricingPrices, limits, allowed content types and the payment network. Free.
remove_passwordwrite actionRemove the password; the public address then stops serving the item (signed share links still work). Free.
retrieveRetrieve an item's content. Counts one read. Text and JSON are returned inline; binary content is returned
revoke_linksInvalidate every share link issued so far for the item (new ones can still be created). The password address is unaffected. Free.
set_passwordProtect the item's public address with a password (12 to 128 characters) and return that address. Anyone who
share_linkwrite actionCreate a signed, time-limited URL that lets anyone (a human in a browser, another agent) read the item without
statusExpiry, remaining reads, size, type and whether a password is set. Free, does not count as a read.
storeStore JSON, text or a file privately for 1 to 365 days (default 7). A paid call (one credit or $0.01 USDC) that includes 100 reads.
store_publicStore JSON, text or a small file (up to 10 MB) as a PUBLIC item for 1 to 7 days, free, no payment or key needed.
wallet_statusThe paying wallet's address and USDC balance on the configured network, and how to fund it. Free.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 5 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
How Fileshareforagents compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 16
- the typical server has 7
- Tools that change things
- 38%
- typical: 0%. Fewer write tools means less an agent can break
What its tools let an agent do: 8 read · 4 change · 3 delete · 1 send or post
Release history: 2 versions in the registry since 2026-09-18, latest 2026-09-28, typically one every 10 days.
Install Fileshareforagents in Claude Code, Cursor or VS Code
Runs npx -y fileshareforagents-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp -- npx -y fileshareforagents-mcp
What the publisher says
From the Fileshareforagents repository's README, as published. We do not edit it. Read it on GitHub
fileshareforagents
Client code for fileshareforagents.online: storage and file sharing for AI agents, paid per call in USDC through the x402 protocol on Base. No account, no API key, no sign-up. Every paid call costs $0.01; status, share links, passwords, delete and feedback are free.
An agent stores JSON or a file (up to 25 MB, 1 to 365 days), gets an id and a one-time secret, and can hand the content to a human or another agent with a signed link or a password-protected address. Content is deleted at expiry.
In this repo
60-second start (MCP)
Claude Code:
claude mcp add fileshare -e WALLET_KEY=0x... -e FILESHARE_NETWORK=testnet -- npx -y fileshareforagents-mcpClaude Desktop, Cursor, Windsurf and other clients:
{
"mcpServers": {
"fileshare": {
"command": "npx",
"args": ["-y", "fileshareforagents-mcp"],
"env": { "WALLET_KEY": "0x...", "FILESHARE_NETWORK": "testnet" }
}
}
}testnet (the default) uses Base Sepolia with free test USDC from faucet.circle.com. mainnet uses real USDC on Base. The wallet needs no ETH; the payment facilitator pays gas. The key stays on your machine.
The API in one paragraph
POST /v1/items with the content as the body. Without payment the API answers 402 Payment Required with everything an x402 client needs; with a paying client the same request returns 201 with id, secret, expires_at and links. Then GET /v1/items/{id} (Bearer secret) reads it back, POST /v1/items/{id}/links makes a signed share URL, PUT /v1/items/{id}/password protects the public address, and DELETE /v1/items/{id} removes it. Full description written for agents: llms.txt. OpenAPI: openapi.json. Function-calling definitions: tools.json.
Prices
Feedback and abuse
POST https://fileshareforagents.online/v1/feedback with {"type": "missing" | "bug" | "abuse" | "other", "message": "..."}. Abuse reports about a specific item include its item_id. Terms: https://fileshareforagents.online/terms.
MIT licensed.
Nothing above is checked by us. What we check is on the safety report.
Fileshareforagents: common questions
- Is Fileshareforagents MCP server safe?
- Mostly: it is graded B (82/100). Read the Fileshareforagents safety report
- How do I install Fileshareforagents?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Fileshareforagents need an API key?
- Yes. The registry entry asks for
FILESHARE_API_KEY,WALLET_KEY. - Is Fileshareforagents maintained?
- The last commit was 37 days ago (2026-09-28). The latest release is v0.2.0.
- How does Fileshareforagents compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 16 (the typical server has 7); tools that change things 38% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.