glashaus-mcp

Pin files, folders, and websites to IPFS directly from Claude. Payments are automatic — your EVM wallet signs x402 challenges locally using USDC on Base. No account needed, no manual signing.

Free tier: files ≤ 100 MB with a 1-day TTL are pinned at no cost (GitHub account required to unlock).

Latest: v0.6.1 — Phase 6 complete (IPNS + Custom Domain Synergy), smart update flow

Install in 30 seconds

Claude Code

claude mcp add glashaus-mcp -- npx -y glashaus-mcp-server

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "glashaus": {
      "command": "npx",
      "args": ["-y", "glashaus-mcp-server"]
    }
  }
}

Then restart Claude Desktop.

Set up your wallet

Run the interactive wizard once to configure a wallet and save it:

npx glashaus-mcp

This generates or imports an EVM wallet, saves the private key to ~/.glashaus-mcp/config.json (mode 600), and registers the server with Claude Code automatically. Your config is loaded on every future server start — no further setup needed.

Subsequent runs: The CLI detects an existing installation and offers a quick menu:

• Update/verify — Copy the latest binary (2 seconds, keeps your wallet & settings)
• Reconfigure — Re-run the full setup wizard (change wallet, tool categories, etc.)
• Skip — Exit and keep current config unchanged

Alternative — environment variable (CI / production agents):

{
  "mcpServers": {
    "glashaus": {
      "command": "npx",
      "args": ["-y", "glashaus-mcp-server"],
      "env": { "X402_WALLET_KEY": "0x<your-64-hex-char-private-key>" }
    }
  }
}

Alternative — session injection (no restart needed):

Ask Claude any time during a chat:

"Set my wallet key: 0x…"

Claude calls import_wallet, which validates the key and activates it immediately for the rest of the conversation.

Security note: Only call import_wallet in a private conversation — the private key appears in the tool call, which may be logged by your client.

Usage

Once installed, just ask Claude:

• "Pin this file to IPFS" — attach a file or give a path
• "Upload my website at ./dist to IPFS" — deploys a folder containing index.html
• "How many views did Qm… get this week?" — analytics by CID
• "Point mysite.com at Qm…" — custom domain mapping
• "What does Glashaus cost?" — pricing and free tier

Mistral Le Chat (HTTP connector)

Le Chat uses a publicly hosted HTTP/SSE endpoint at https://glashaus.xyz/api/mcp.

1. Go to le.chat → Settings → Intelligence → Connectors

2. Click + Add Connector → Custom MCP Connector

3. Fill in:

   | Field | Value | |---|---| | Name | Glashaus | | URL | https://glashaus.xyz/api/mcp | | Description | Upload files to IPFS, manage domains, view analytics | | Authentication | None |

4. Click Connect

Note: Le Chat uploads use a shared server-side wallet. For your own wallet and billing isolation, use Claude Desktop or Claude Code.

Pricing

Formula: sizeGB × ttlDays × $0.01 USDC

Free tier: files ≤ 100 MB with a 1-day TTL — requires a linked GitHub account. Use start_github_link to connect, then check_github_link to confirm.

Fund a testnet wallet at faucet.circle.com (select Base Sepolia).

Tools

Getting started

| Tool | What it does | |---|---| | explain_setup | First-run guide: install, configure wallet, fund with USDC, first upload | | setup_wallet | Step-by-step wallet setup checklist for Base Sepolia or Base Mainnet | | import_wallet | Activate a private key for this session — no restart needed | | get_wallet_info | Show the active wallet address and network |

Uploading

| Tool | What it does | |---|---| | check_path | Verify a file or directory exists before uploading | | upload_files | Upload a file, folder, or website to IPFS via TUS streaming. Two-phase: call to preview cost, then re-call with confirmed: true after the user approves payment | | get_deployment_status | Check whether pinned content is still live |

Analytics

| Tool | What it does | |---|---| | get_analytics | Complete analytics for a CID: views, bandwidth, session duration, devices, entry pages, UTM campaigns, gateway stats | | list_files | All files uploaded by the current wallet | | get_agent_stats | Account summary: total files, storage, and estimated USDC cost |

Domains

| Tool | What it does | |---|---| | add_domain | Point a custom domain at a CID. If the CID has IPNS enabled, the domain auto-updates to the latest version on each re-deploy (no re-verification needed). | | remove_domain | Remove a custom domain | | list_domains | All domains registered to the current wallet |

Free tier & GitHub

| Tool | What it does | |---|---| | explain_free_tier | How the free tier works and how to unlock it | | start_github_link | Link wallet to GitHub to unlock 100 MB/day free storage | | check_github_link | Check whether the free tier is active for this wallet |

Reference

| Tool | What it does | |---|---| | get_pricing | Pricing formula and cost examples | | get_system_info | Platform capabilities, rate limits, and docs links | | get_network_info | RPC endpoints, USDC contracts, faucets | | get_deployment_api | Full REST API reference with curl examples | | get_implementation_guide | Integration guide (JavaScript, Python, Go) | | explain_architecture | How Glashaus is built | | explain_deployment_flow | Full upload-to-IPFS flow | | explain_upload | TUS streaming, S3, UnixFS, and CID derivation | | explain_deploy | Upload vs deploy — when a folder becomes a website | | explain_x402_payment | 402 challenge-response and USDC on Base | | explain_wallet_setup | Wallet security and key management | | explain_domains | DNS records, verification, and Host-header routing | | explain_wallet | Key formats, signing, funding, and security | | explain_cid_and_indexing | CID generation, MongoDB indexing, gateway streaming, DHT |

Tool filtering

Set GLASHAUS_TOOL_FILTER to expose only the tools your agent needs:

GLASHAUS_TOOL_FILTER=upload,analytics     # upload + analytics only
GLASHAUS_TOOL_FILTER=docs                 # educational tools only (no wallet needed)
GLASHAUS_TOOL_FILTER=all                  # all tools (default)

Categories: upload, analytics, domains, docs.

Environment variables

| Variable | Purpose | |---|---| | X402_WALLET_KEY | EVM private key (0x…). Falls back to ~/.glashaus-mcp/config.json, then import_wallet. | | GLASHAUS_TOOL_FILTER | Comma-separated categories to expose | | API_URL | Override API base URL (default: https://glashaus.xyz) |

Changelog

v0.6.1 (2026-06-29)

• New: Smart update flow in CLI — skip setup wizard on subsequent runs, just update the binary
• Menu options: Update/verify (2s), Reconfigure (full setup), Skip

v0.6.0 (2026-06-29)

• New: Phase 6 complete — IPNS + Custom Domain Synergy
• Feature: Domains now auto-detect IPNS backing on attachment; auto-update to latest CID on re-deploy
• Feature: add_domain tool response shows IPNS status with auto-update confirmation
• Fix: Domain resolution caches IPNS with 5-minute TTL; re-deploy invalidates cache
• Fix: Enable IPNS endpoint back-fills existing domains with IPNS name
• Tests: 47 IPNS integration tests passing

Development

cd packages/glashaus-mcp
npm install
npm run build      # compile src/ → dist/
npm run dev        # watch mode
node dist/server.js

Publishing

npm publish --workspace packages/glashaus-mcp --tag beta
npm publish --workspace packages/glashaus-mcp --tag latest