English Français العربية

online.fileshareforagents/mcp

Official registry AI and agents

Storage for AI agents: free public items, or private items paid with credits or USDC (x402).

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package fileshareforagents-mcp
Claude Code 
claude mcp add online-fileshareforagents-mcp -e 'FILESHARE_API_KEY=<your fileshare_api_key>' -e 'WALLET_KEY=<your wallet_key>' -e 'FILESHARE_NETWORK=testnet' -- npx -y fileshareforagents-mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "online-fileshareforagents-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "fileshareforagents-mcp@0.2.0"
            ],
            "env": {
                "FILESHARE_API_KEY": "<your fileshare_api_key>",
                "WALLET_KEY": "<your wallet_key>",
                "FILESHARE_NETWORK": "testnet"
            }
        }
    }
}

Environment variables

  • FILESHARE_API_KEY secret Account key (fsa_...) from https://fileshareforagents.online/dashboard. Each paid call spends one prepaid credit; no wallet needed. Optional.
  • WALLET_KEY secret Private 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_NETWORK testnet (default, Base Sepolia with free test USDC) or mainnet (Base, real USDC).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. fileshareforagents
  2. In this repo
  3. 60-second start (MCP)
  4. The API in one paragraph
  5. Prices
  6. Feedback and abuse

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

PathWhat
mcp/The MCP server, published as fileshareforagents-mcp on npm and as online.fileshareforagents/mcp in the official MCP registry.
examples/typescript/Upload, share with a human, delete, using @x402/fetch.
examples/python/The same flow with the x402 Python package.
examples/curl.shThe free surface and the 402 handshake, no wallet needed.

60-second start (MCP)

Claude Code:

claude mcp add fileshare -e WALLET_KEY=0x... -e FILESHARE_NETWORK=testnet -- npx -y fileshareforagents-mcp

Claude 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

OperationPrice
Store (includes 100 reads)$0.01
Extend expiry$0.01
1,000 extra reads$0.01
Everything elsefree

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.

Frequently asked questions

What is online.fileshareforagents/mcp?

Storage for AI agents: free public items, or private items paid with credits or USDC (x402).

How do I install online.fileshareforagents/mcp?

It runs on your machine. In Claude Code: claude mcp add online-fileshareforagents-mcp -e 'FILESHARE_API_KEY=<your fileshare_api_key>' -e 'WALLET_KEY=<your wallet_key>' -e 'FILESHARE_NETWORK=testnet' -- npx -y fileshareforagents-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does online.fileshareforagents/mcp need an API key?

Yes. It expects FILESHARE_API_KEY, WALLET_KEY, which you set in its configuration.

Is online.fileshareforagents/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains online.fileshareforagents/mcp?

It is published by OrenRachamim. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.