online.fileshareforagents/mcp
Storage for AI agents: free public items, or private items paid with credits or USDC (x402).
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
fileshareforagents-mcpclaude 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
{
"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"
}
}
}
}
Variables d'environnement
FILESHARE_API_KEYsecret Account key (fsa_...) from https://fileshareforagents.online/dashboard. Each paid call spends one prepaid credit; no wallet needed. Optional.WALLET_KEYsecret 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_NETWORKtestnet (default, Base Sepolia with free test USDC) or mainnet (Base, real USDC).
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
| Path | What |
|---|---|
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.sh | The 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
| Operation | Price |
|---|---|
| Store (includes 100 reads) | $0.01 |
| Extend expiry | $0.01 |
| 1,000 extra reads | $0.01 |
| Everything else | free |
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.
Questions fréquentes
Qu'est-ce que online.fileshareforagents/mcp ?
Storage for AI agents: free public items, or private items paid with credits or USDC (x402).
Comment installer online.fileshareforagents/mcp ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour online.fileshareforagents/mcp ?
Oui. Il attend FILESHARE_API_KEY, WALLET_KEY, à renseigner dans sa configuration.
online.fileshareforagents/mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient online.fileshareforagents/mcp ?
Il est publié par OrenRachamim. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.