Use Foldr with Haystack (MCP)
Haystack is deepset's open-source LLM framework focused on production RAG and search pipelines, heavily used by enterprise NLP teams. Haystack's `MCPToolset` component wraps any MCP server as a pipeline tool. Foldr is useful when a Haystack pipeline produces a report and needs to hand it off as a public URL.
Installation
Add the Foldr MCP server to Haystack with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
pip install haystack-mcp
# Python
from haystack_integrations.tools.mcp import MCPToolset, StdioServerInfo
toolset = MCPToolset(server_info=StdioServerInfo(
command="npx", args=["-y", "@foldr/mcp-server"],
env={"FOLDR_API_KEY": "fs_live_..."}
))What You Can Do
- Upload any file from Haystack to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving Haystack
- Create or update a Foldr bio page from a Haystack conversation
- Generate a hosted Foldr form and paste the submission URL into your reply
- Wire Foldr tools into any existing Haystack agent with a few lines of config
Haystack + Foldr FAQ
How do I install the Foldr MCP server in Haystack?
Open Haystack's MCP configuration (the CLI) and paste the config block shown above. Set FOLDR_API_KEY to a key you create at foldr.space/api-keys. Restart Haystack if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with Haystack?
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 Haystack says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) Haystack 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 Haystack upload files directly to Foldr, or just generate URLs?
Haystack 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 Haystack can read from disk can be uploaded.
Is the Foldr MCP integration with Haystack production-ready?
Foldr's MCP server is stable and used in production. Haystack's MCP support is currently in public beta — suitable for day-to-day use. We pin to stable SDK versions and publish changelog entries for every breaking change.
Related MCP Integrations
Connect Haystack to Foldr in under a minute
Grab an API key, paste the snippet above into Haystack's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key