Use Foldr with Hugging Face Chat UI (MCP)
HF Chat UI is the open-source chat front-end behind HuggingChat, designed to run with any Text Generation Inference endpoint. Hugging Face added MCP tool support in early 2026. Foldr is a practical add-on for teams running their own HuggingChat deployment who need a shareable-output story.
Installation
Add the Foldr MCP server to Hugging Face Chat UI with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
# In .env.local
MCP_SERVERS='[
{
"name": "foldr",
"command": "npx",
"args": ["-y", "@foldr/mcp-server"],
"env": { "FOLDR_API_KEY": "fs_live_..." }
}
]'What You Can Do
- Upload any file from Hugging Face Chat UI to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving Hugging Face Chat UI
- Create or update a Foldr bio page from a Hugging Face Chat UI conversation
- Generate a hosted Foldr form and paste the submission URL into your reply
Hugging Face Chat UI + Foldr FAQ
How do I install the Foldr MCP server in Hugging Face Chat UI?
Open Hugging Face Chat UI'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/api-keys. Restart Hugging Face Chat UI if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with Hugging Face Chat UI?
The Foldr MCP server is available on every paid plan (Pro from $5/mo and Developer tier for API-heavy usage). The free tier can generate temporary 7-day links; for permanent storage, a Pro plan or Foldr Space is required.
I set the key but Hugging Face Chat UI says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) Hugging Face Chat UI wasn't restarted after editing the config — most MCP hosts need a restart to pick up new servers. (2) Your API key is missing the `mcp:invoke` scope. Regenerate a key at foldr.space/api-keys with full scope and retry.
Can Hugging Face Chat UI upload files directly to Foldr, or just generate URLs?
Hugging Face Chat UI can do both. The MCP server exposes tools for `upload_file` (takes a local path or base64 blob), `shorten_url`, and `create_bio_page`. Any file Hugging Face Chat UI can read from disk can be uploaded.
Is the Foldr MCP integration with Hugging Face Chat UI production-ready?
Foldr's MCP server is stable and used in production. Hugging Face Chat UI's MCP support is currently experimental — expect rough edges and breaking changes. We pin to stable SDK versions and publish changelog entries for every breaking change.
Related MCP Integrations
Connect Hugging Face Chat UI to Foldr in under a minute
Grab an API key, paste the snippet above into Hugging Face Chat UI's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key