Use Foldr with llm (Simon Willison) (MCP)
Simon Willison's `llm` is the beloved Python-based CLI for chatting with any LLM from the terminal, with plugins for every major provider. The `llm-mcp` plugin wires in MCP servers as tools. Combined with Foldr, you can pipe any file into `llm` and have it respond with an uploaded URL — a one-liner replacement for ad-hoc curl scripts.
Installation
Add the Foldr MCP server to llm (Simon Willison) with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
llm install llm-mcp llm mcp add foldr \ --command "npx -y @foldr/mcp-server" \ --env FOLDR_API_KEY=fs_live_...
Setup tip: Use `llm -T foldr "Upload this file"` to invoke the server from a chat turn.
Official llm (Simon Willison) MCP docsWhat You Can Do
- Upload any file from llm (Simon Willison) to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving llm (Simon Willison)
- Create or update a Foldr bio page from a llm (Simon Willison) conversation
- Generate a hosted Foldr form and paste the submission URL into your reply
- Hand off build artifacts, screenshots, and logs to a URL without leaving your editor
llm (Simon Willison) + Foldr FAQ
How do I install the Foldr MCP server in llm (Simon Willison)?
Open llm (Simon Willison)'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 llm (Simon Willison) if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with llm (Simon Willison)?
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 llm (Simon Willison) says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) llm (Simon Willison) 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 llm (Simon Willison) upload files directly to Foldr, or just generate URLs?
llm (Simon Willison) 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 llm (Simon Willison) can read from disk can be uploaded.
Is the Foldr MCP integration with llm (Simon Willison) production-ready?
Foldr's MCP server is stable and used in production. llm (Simon Willison)'s MCP support is currently community-maintained — check the upstream repo for current status. We pin to stable SDK versions and publish changelog entries for every breaking change.
Related MCP Integrations
Connect llm (Simon Willison) to Foldr in under a minute
Grab an API key, paste the snippet above into llm (Simon Willison)'s MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key