Enterprise Platforms

Use Foldr with n8n AI Nodes (MCP)

n8n is the open-source, self-hostable workflow automation platform and a favourite of technical ops teams. n8n 1.60 added MCP Client and MCP Trigger nodes that let workflows both consume and expose MCP servers. Foldr can be called from an n8n AI Agent node or reached from Claude via n8n's own MCP trigger.

n8nSelf-hosted or n8n CloudMCP: beta

Installation

Add the Foldr MCP server to n8n AI Nodes 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.

// In n8n → AI Agent node → Tools → Add MCP Client
{
  "command": "npx",
  "args": ["-y", "@foldr/mcp-server"],
  "environment": { "FOLDR_API_KEY": "fs_live_..." }
}

Setup tip: Available in n8n Community 1.60+ and Cloud. Self-host recommended for production.

Official n8n AI Nodes MCP docs

What You Can Do

  • Upload any file from n8n AI Nodes 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
  • Keep upload audit trails in Foldr while letting n8n AI Nodes orchestrate the workflow

n8n AI Nodes + Foldr FAQ

How do I install the Foldr MCP server in n8n AI Nodes?

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

How much does it cost to use Foldr from n8n AI Nodes?

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 n8n AI Nodes says the Foldr tool isn't available - what's wrong?

Three common causes: (1) n8n AI Nodes 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 n8n AI Nodes's docs for the version that added MCP support.

Can n8n AI Nodes upload files directly to Foldr, or just generate URLs?

n8n AI Nodes 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 n8n AI Nodes can read from disk can be uploaded.

Is the Foldr MCP integration with n8n AI Nodes production-ready?

Foldr's MCP server is stable and used in production - streamable-http transport at https://foldr.space/api/mcp with 23 tools. n8n AI Nodes's MCP support is currently in public beta - suitable for day-to-day use. Every write endpoint accepts an Idempotency-Key so retries are safe.

Related MCP Integrations

Connect n8n AI Nodes to Foldr in under a minute

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