# MCP

> MCP is a freemium MCP server for files and documents. Store files or JSON for agents and share links with humans, free for public items. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI
- **Website:** https://fileshareforagents.online
- **Repository:** https://github.com/orenrachamim/fileshareforagents/tree/HEAD/mcp
- **MCP Registry name:** online.fileshareforagents/mcp
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env FILESHARE_API_KEY='<FILESHARE_API_KEY>' --env WALLET_KEY='<WALLET_KEY>' -- npx -y fileshareforagents-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fileshareforagents-mcp"
      ],
      "env": {
        "FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
        "WALLET_KEY": "<WALLET_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fileshareforagents-mcp"
      ],
      "env": {
        "FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
        "WALLET_KEY": "<WALLET_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fileshareforagents-mcp"
      ],
      "env": {
        "FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
        "WALLET_KEY": "<WALLET_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fileshareforagents-mcp"
      ],
      "env": {
        "FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
        "WALLET_KEY": "<WALLET_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fileshareforagents-mcp"
      ],
      "env": {
        "FILESHARE_API_KEY": "<FILESHARE_API_KEY>",
        "WALLET_KEY": "<WALLET_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-mwepf9pf
