CLI & Terminal

Use Foldr with Claude Code (MCP)

Claude Code is Anthropic's official agentic CLI for Claude, built for power users who want Claude to operate directly on their filesystem. It ships with native MCP support and a `claude mcp add` command. With Foldr configured, Claude Code can hand you a shareable URL for any file it just generated - ideal for CI reports, design exports, and debug bundles.

AnthropicmacOS, Linux, Windows (WSL)MCP: stable

Installation

Add the Foldr MCP server to Claude Code with the snippet below. Replace fs_… with an API key from foldr.space/developers/signup. Each upload costs 5¢ - top up account credits or subscribe to Pro tier to bypass per-call charges.

claude mcp add foldr \
  --env FOLDR_API_KEY=fs_live_... \
  -- npx -y @foldr/mcp-server

Setup tip: Scope the server with --scope user (across projects) or --scope project (just this repo). Remove with "claude mcp remove foldr".

Official Claude Code MCP docs

What You Can Do

Upload any file from Claude Code to Foldr and get a permanent shareable URL back in the same turn (5¢ per upload, debited from credits)
Mint short-lived capability tokens to share files with downstream agents without leaking your API key
Organize uploads into per-API-key folders with hierarchical structure
Shorten long URLs to foldr.space/s/... links - free with any API key
Hand off build artifacts, screenshots, and logs to a URL without leaving your editor

Claude Code + Foldr FAQ

How do I install the Foldr MCP server in Claude Code?

Open Claude Code's MCP configuration (the CLI) and paste the config block shown above. Set FOLDR_API_KEY to a key you create at foldr.space/developers/signup. Restart Claude Code if it doesn't hot-reload.

How much does it cost to use Foldr from Claude Code?

Each upload costs 5¢. You can pay by topping up account credits via the `top_up_credits` MCP tool (min $5) - every upload then debits from balance. Or subscribe to Pro tier ($25/mo) and per-call charges are bypassed entirely. Tools that don't write data (list_files, mint_capability, get_usage, etc.) are free.

I set the key but Claude Code says the Foldr tool isn't available - what's wrong?

Three common causes: (1) Claude Code wasn't restarted after editing the config - most MCP hosts need a restart to pick up new servers. (2) The API key is wrong or missing - verify the env var name your client reads (e.g. FOLDR_API_KEY) matches the config snippet above. (3) Your client doesn't support the streamable-http transport - most modern clients do, but check Claude Code's docs for the version that added MCP support.

Can Claude Code upload files directly to Foldr, or just generate URLs?

Claude Code can do both. The MCP server exposes tools for `upload_file` (base64-encoded file content), `bulk_upload` (up to 20 files in one call), `mint_capability` (short-lived shareable links), and `create_short_url`. Any file Claude Code can read from disk can be uploaded.

Is the Foldr MCP integration with Claude Code production-ready?

Foldr's MCP server is stable and used in production - streamable-http transport at https://foldr.space/api/mcp with 23 tools. Claude Code's MCP support is currently stable and generally available. Every write endpoint accepts an Idempotency-Key so retries are safe.

Related MCP Integrations

Foldr + Gemini CLI

CLI & Terminal

Foldr + OpenAI Codex CLI

CLI & Terminal

Foldr + llm (Simon Willison)

CLI & Terminal

Foldr + Claude Desktop

Desktop IDEs & AI Apps

Foldr + Cursor

Desktop IDEs & AI Apps

Browse all MCP integrations

Connect Claude Code to Foldr in under a minute

Grab an API key, paste the snippet above into Claude Code's MCP config, top up credits (or grab a Pro subscription), and your agent can upload files and mint share links immediately.

Get your Foldr API key x402 details