x4

x402 Dev Console

v1.0.0

← Back to MCP Servers
╭──╮
│IP│
│FS│
╰──╯

IPFS Storage Service

v1.3.0StorageTools 4 actions
Use with an LLMTry in Playground

SERVER URL

http://localhost:3000/api/mcp-server/ipfs-storage

CONNECTION JSON

{
  "mcpServers": {
    "ipfs-storage": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "http://localhost:3000/api/mcp-server/ipfs-storage"
      ]
    }
  }
}

Learn more about supported MCP clients

MCP HOST CONNECTIONS

Connect this MCP server directly to your AI assistant tools by using the JSON config above. Click on a logo to see a demo video.

╔═══╗
║ ▸ ║
║ │ ║
╚═══╝
CursorWatch demo
┌───┐
│ C │
│ L │
└───┘
ClaudeWatch demo

DESCRIPTION

Upload and pin files to IPFS with automatic x402 payment integration. Pay only for storage used - no monthly fees. Includes CDN acceleration and automatic garbage collection.

AVAILABLE TOOLS

x402_storage_balance

Check storage balance and payment status

upload_file

Upload file to IPFS (charges via x402)

pin_cid

Pin existing IPFS CID (charges via x402)

get_file

Retrieve file from IPFS (free for own files)

CODE EXAMPLES

JavaScript
// IPFS Storage with x402
import { Client } from '@modelcontextprotocol/sdk';

const client = new Client();
await client.connect('https://ipfs.x402.app/mcp');

// Upload file (auto-pays for storage)
const result = await client.callTool({
  name: 'upload_file',
  arguments: {
    data: base64EncodedFile,
    filename: 'myfile.jpg',
    wallet: 'YourWallet...'
  }
});

console.log('IPFS CID:', result.cid);

Official MCP SDK Documentation:
https://github.com/modelcontextprotocol/modelcontextprotocol

Installation:
npm install @modelcontextprotocol/sdk

Authentication:
- For MCP Hosts (Cursor, Windsurf, Claude Desktop), saving the JSON config to your tool will automatically trigger the browser OAuth flow
- For programmatic access, obtain the OAuth token by running "npx mcp-remote <url>" in the terminal and follow the instructions

x4