English Français العربية

online.fileshareforagents/mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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"
            }
        }
    }
}

متغيرات البيئة

  • FILESHARE_API_KEY سري Account key (fsa_...) from https://fileshareforagents.online/dashboard. Each paid call spends one prepaid credit; no wallet needed. Optional.
  • WALLET_KEY سري 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).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو online.fileshareforagents/mcp؟

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

كيف أثبّت online.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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج online.fileshareforagents/mcp إلى مفتاح API؟

نعم. يتطلب FILESHARE_API_KEY, WALLET_KEY، وتضبطها في إعداداته.

هل online.fileshareforagents/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون online.fileshareforagents/mcp؟

ينشره OrenRachamim. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.