Glashaus

Upload to IPFS
with natural language

npx glashaus-mcp

Pinning service built for AI agents. No dashboards. Connect a Coinbase CDP wallet and start uploading — cost preview and user confirmation before every payment.

Getting StartedLearn More

See costs before paying. Confirm uploads interactively. Pay only for what you pin.

At a Glance

The essential facts agents need before integrating.

Glashaus platform facts
What it is
Agent-first IPFS content pinning. Upload files, directories, and websites; receive a permanent content-addressed CID.
Pricing
Pay-per-use: sizeGB × ttlDays × $0.01 USDC. No subscriptions.
Free tier
100 MB total for 1-day pins — link a GitHub account once to unlock.
Authentication
EVM wallet signatures via the x402 payment protocol; USDC settled on Base. No accounts.
Interfaces
MCP server (Claude), CLI, REST API, plus Discord and Telegram bots.
Content addressing
CIDv1 (bafybei…); gateway URL https://glashaus.xyz/gateway/{cid}.
Machine-readable docs
/llms.txt, /api/openapi.json, and /.well-known/ai-plugin.json.

Built for Autonomous Deployment

Non-custodial agents, transparent pricing, secure wallets, and immutable on-chain settlement.

Coinbase CDP Wallet

The MCP server signs x402 payments with a Coinbase CDP agentic wallet. Configure API credentials once — no private keys to generate or manage.

Cost Preview

See exact cost before uploading. Interactive confirmation required. No surprise charges.

No Key Custody

Coinbase holds the key in a secure enclave. Neither Glashaus nor your client ever sees a raw private key — only signed payment proofs.

IPFS Native

Content pinned to IPFS. Distributed globally. DHT announces propagate to peers automatically.

Micro-Payments

Pay per operation. No subscriptions. No minimum spend. Just usage.

Agent SDK

Build agents that upload autonomously. Use Claude, local models, or any LLM with our SDK.

CLI Ready

Upload from the command line. Shows costs. Asks for confirmation. No dashboards needed.

Encrypted API Secrets

Store third-party API keys encrypted server-side. Deployed sites call a secure proxy that injects secrets before forwarding. Keys never exposed to browser.

IPFS Node API

Full Kubo-compatible REST surface: pin ls, dag stat, block stat, ls, swarm peers, routing findprovs. Query and manage pins programmatically.

Prometheus Metrics

Operation-level counters and histograms for every deploy, upload, pin, and domain op. Scrape /api/metrics and wire to Grafana in minutes.

Learn How It Works

Two guides explain the core workflows end to end — how content is stored on IPFS, and how a folder becomes a live website. Browse everything in the documentation overview.

IPFS Storage

How content addressing, the self-hosted gateway, block storage, and DHT announcement work — plus the console and MCP commands to inspect it all.

Read the guide

Website Deployment

From build output to a live site: storage vs deployments, the four-step workflow, subdomain URLs, custom domains, analytics, and encrypted API secrets.

Read the guide

API Reference

Interactive Swagger UI, REST endpoints, and MCP tools with examples.

MCP Server

Installation guide, tool reference, and quick start for Claude.

Pricing

Pay-per-use cost formula, examples, free tier, and FAQ.

Interfaces & Integrations

Use Glashaus from your community or locally. MCP for Claude, CLI for developers, bots for Discord and Telegram.

MCP Server

Run in Claude. 54 tools for upload, deployment, analytics, and IPFS operations. No dashboard. Just natural language.

Learn more

REST API

Upload, deploy, and query analytics programmatically. OpenAPI spec. x402 payment protocol. Signature-authenticated agents.

Learn more

Community Bots

Discord and Telegram bots with per-server/group wallets, spending limits, GitHub free tier, and AI @mentions.

Learn more

glashaus-console

Early Access

Terminal agent — upload, deploy, and manage pins with natural language. Supports Groq, OpenAI, Anthropic, and Ollama. No Claude subscription needed.

Learn more

Two-Step Upload: Preview & Confirm

1

Call upload_files

Agent calls MCP tool: upload_files {file_path}

↓
2

Get Cost Preview

Server calculates cost and returns a price preview

100 MB × 365 days = $0.001 USDC

↓
3

User Confirms

Agent asks user: "Deploy for $0.001? (yes/no)"

User confirms in chat

↓
4

Re-call with confirmed

Agent calls: upload_files {file_path, confirmed: true}

↓
5

Server Validates & Deploys

CDP wallet signs the x402 challenge; USDC settles on-chain via the facilitator

↓
6

Upload Complete

Return {cid, gateway_url, cost_usdc}. Content is live on IPFS.

No surprise charges. Users see cost → confirm → pay. Safe, transparent, and user-friendly.

Deploy as a Website

Any uploaded folder with an index.html becomes a live website. One extra step promotes a CID to a routable site.

Upload vs. Website vs. Custom Domain

  • /gateway/{cid}Raw IPFS gateway — any file or directory, always available after upload
  • /deployment/{cid}Deployment mode — serves index.html, correct MIME types, SPA routing support
  • yourdomain.comCustom domain — point any domain at a deployed CID via add_domain or POST /api/domain
Read the deployment guide

Censorship-Resistant by Design

Your content lives on a global distributed network. No single entity controls it.

Globally Distributed

Content pinned to IPFS is replicated across nodes worldwide. No single point of failure. No central authority can block access.

Content-Addressed

CIDs are permanent. A file's address is derived from its cryptographic hash. The same file always has the same address — immutable by design.

You Own Your Domain

Custom domains are yours to control. Update DNS records anytime. Point at any CID. Switch providers without losing your presence.

Peer-to-Peer Access

Content can be served from any peer on the DHT. No gateway dependency. Run your own gateway. Participate in the network you rely on.

Why IPFS Deployments Are Resilient

  • •No domain registrar can revoke your presence — your site is identified by its content hash, not a domain name alone
  • •No hosting provider can take it down — the network is decentralised and participants are autonomous
  • •No single firewall can block it — content flows through multiple peers simultaneously
  • •Custom domains give you optionality — even if one gateway is blocked, others remain accessible

Get Started in Three Steps

One installer. Guided wallet setup. No dashboards.

1

Run the installer

Walks through tool selection, wallet setup (generate new or import), and configures Claude Code automatically.

bash
npx glashaus-mcp
2

Fund your wallet

The installer shows your wallet address and a faucet link. Add USDC on Base Sepolia (testnet, free) or Base Mainnet for production. Link your GitHub account once to unlock 100 MB/day free — no USDC needed.

3

Ask Claude to upload

Claude shows cost, you confirm, it pins to IPFS.

prompt
Upload my files to IPFS

Free Tier: Test Without Spending

  • ✓100 MB/day free — link your GitHub account once to unlock, no wallet funds needed
  • ✓Cost preview before every upload — no surprise charges
  • ✓Live IPFS pinning and DHT propagation
  • ✓Full access to production API and all information endpoints
  • ✓Activate in seconds — ask the agent: "connect my GitHub for the free tier"

For longer pins, see pricing — or fund your Coinbase wallet with USDC on Base Mainnet and scale to production.

Simple, Transparent Pricing

Pay only for what you deploy. No subscriptions. No hidden fees. See costs before deploying.

$0.01 / GB / day

Free tier: 100 MB/day for 1-day pins — link GitHub once to unlock

Query cost anytime: GET /api/pricing?size_bytes=X&ttl_days=Y

View full pricing

Ready to Build?

Start testing with the free MCP server today. See costs before paying. Confirm uploads interactively.

MCP Server Docs API Reference

By using Glashaus, you agree to our Terms of Service and Privacy Policy.