
MCP
Store files or JSON for agents and share links with humans, free for public items
- Pricing
- Freemium
- Platforms
- Web, API, CLI
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- 1 day ago
About MCP
MCP is a freemium MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Fileshare for agents works as a drop box: an agent stores content, gets back an id, a one-time secret, an expiry and links, and hands a link to a person or another agent. The site stresses that it is not a vault. Expired or deleted items vanish with no backup.
Public items last up to 7 days, up to 10 MB with 100 opens, at no cost. Private items run for 1 to 365 days up to 25 MB, protected by a secret, signed time-limited links or a password, and cost one cent per paid call. Payment is by prepaid credits tied to an API key (10 included at signup) or by USDC over x402 from a wallet on Base. The default network is Base Sepolia testnet with free test USDC.
The npm package fileshareforagents-mcp runs locally over stdio. Its 16 tools cover storing, retrieving, extending, buying reads, share links, passwords, deletion, pricing, wallet status and feedback. Allowed content includes JSON, text, Markdown, CSV, HTML, SVG, PDF and common image formats.
Install
Run in a terminal
claude mcp add mcp --env FILESHARE_API_KEY='<FILESHARE_API_KEY>' --env WALLET_KEY='<WALLET_KEY>' -- npx -y fileshareforagents-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"fileshareforagents-mcp"
],
"env": {
"FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
"WALLET_KEY": "<WALLET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"fileshareforagents-mcp"
],
"env": {
"FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
"WALLET_KEY": "<WALLET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fileshareforagents-mcp"
],
"env": {
"FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
"WALLET_KEY": "<WALLET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"fileshareforagents-mcp"
],
"env": {
"FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
"WALLET_KEY": "<WALLET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"fileshareforagents-mcp"
],
"env": {
"FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
"WALLET_KEY": "<WALLET_KEY>"
}
}
}
}Configuration
FILESHARE_API_KEYAccount key (fsa_...) from https://fileshareforagents.online/dashboard. Each paid call spends one prepaid credit; no wallet needed. Optional.WALLET_KEYPrivate key (0x + 64 hex) of a wallet holding USDC on the chosen network. Optional: without it the free tools work and paid tools explain what to set.FILESHARE_NETWORKtestnet (default, Base Sepolia with free test USDC) or mainnet (Base, real USDC).
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- store_public
- Stores a public item for up to 7 days.
- store
- Stores a private item for 1 to 365 days.
- retrieve
- Returns an item's content.
- status
- Shows expiry, reads left, size and type.
- extend
- Extends an item's expiry.
- buy_reads
- Adds 1000 reads to an item.
- share_link
- Creates a signed, time-limited URL.
- revoke_links
- Invalidates issued share links.
- set_password
- Protects the public address with a password.
- remove_password
- Removes the password protection.
- delete
- Permanently deletes an item.
- pricing
- Shows prices, limits and allowed types.
- wallet_status
- Shows paying wallet address and USDC balance.
- account
- Shows credits, files and storage for the API key account.
- buy_credits
- Buys credits with a USDC payment.
- feedback
- Sends a bug, feature request or abuse report.
What it does
- Free public items
- Store public content for up to 7 days at no cost.
- Private storage
- Private items up to 365 days, using a secret, signed links or password.
- Two ways to pay
- Prepaid credits or USDC over x402 at one cent per call.
- Share links
- Signed, time-limited URLs that can be revoked.
- Password protection
- Protect an item's public address with a password.
- Testnet default
- Starts on Base Sepolia so nothing real is at stake.
Good for
- Hand a generated report or CSV to a person as a link
- Pass a large result between two agents without a shared database
- Share a rendered HTML page temporarily
- Store private data with a password-protected address
Pricing
Freemium
Public items free; paid calls $0.01 each
Prices change. Check fileshareforagents.online before you buy.
MCP FAQ
Is there a free tier?
Yes, public items for up to 7 days need no account or payment.
How much do paid calls cost?
One cent per call.
Do I need a wallet?
Not for the free tier or for credits; a wallet with USDC is only for paying per call over x402.
What happens when an item expires?
Its content and metadata are deleted with no recovery.
Is MCP free?
MCP has a free plan, with paid plans for more usage or features.
How do I add MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp --env FILESHARE_API_KEY='<FILESHARE_API_KEY>' --env WALLET_KEY='<WALLET_KEY>' -- npx -y fileshareforagents-mcp
What are the best alternatives to MCP?
The closest alternatives to MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools