1. Conduid
  2. AI
  3. mcp
MCP server · AI

mcp

by · github.com/rawgroundbeef/x402.storage

MCP server for x402.storage file uploads

Unclaimed ai
InstallView source
39Low

Scored 5 months ago · breakdown

About mcp

mcp is an MCP server published by git+rawgroundbeef in the AI category: mCP server for x402.storage file uploads.

Install

Install
npx @x402storage/mcp
Claude Code
claude mcp add x402-storage -- npx -y @x402storage/mcp
npx
npx -y @x402storage/mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about mcp

Powered by Claude · Grounded in docs

I know everything about mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

x402.storage

Permanent file storage. One cent.

Upload any file. Pay once. Keep it forever.

What is this?

x402.storage is a pay-per-use IPFS storage service. Files are stored permanently on IPFS via Filebase, paid for with USDC on Base using the x402 payment protocol.

  • No accounts — Pay directly from your wallet
  • Permanent storage — Files pinned forever on IPFS
  • One cent per file — Flat pricing, no subscriptions

Packages

This monorepo contains three ways to use x402.storage:

Website

The main web interface at x402.storage. Drag and drop files, pay with an auto-generated wallet, get permanent URLs.

CLI

Command-line tool for uploading files:

npm install -g x402store
x402store myfile.pdf
# https://x402.storage/bafybeig...

MCP

Model Context Protocol server for AI agents (Claude Desktop, Claude Code):

npm install -g x402store-mcp

Then configure your AI client to use the store_file tool.

Claude Code Skill

Install the skill for Claude Code:

npx skills add rawgroundbeef/x402.storage

Then use commands like /x402storage:store <file> and /x402storage:resume.

Agent Memory

x402.storage uses the .agent/ directory convention for persistent memory across sessions:

.agent/
  x402-storage/
    memory          # Contains the CID of the last stored context

How it works

  1. Store context: /x402storage:store context.json → saves URL to .agent/x402-storage/memory
  2. New session: /x402storage:resume → reads the CID, fetches your context
  3. Continue where you left off

Team sharing

Commit .agent/x402-storage/memory to git. Teammates run /x402storage:resume to fetch shared context.

Convention for other tools

The .agent/ directory is a proposed convention for agent tooling. Other tools can use .agent/<tool-name>/ for their own persistent storage, enabling interoperability across the agent ecosystem.

Development

# Install dependencies
npm install

# Run website locally
npm run dev

# Build all packages
npm run build

How it works

  1. You upload a file
  2. API returns a 402 Payment Required with price ($0.01)
  3. Your wallet signs a payment authorization
  4. API verifies payment, uploads to IPFS, settles payment
  5. You get a permanent URL

The x402 protocol handles payment negotiation automatically — no manual transaction signing needed.

Cost

$0.01 USDC per file, regardless of size (up to 10MB). Files are stored permanently.

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About mcp

How do I install mcp?

Run npx @x402storage/mcp, then add the server to your MCP client's configuration.

Is mcp safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is mcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.