Skip to content
MCP server

MCP

Store files or JSON for agents and share links with humans, free for public items

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools