Use Foldr with Aider (MCP)
Aider is the popular open-source pair-programming CLI that edits your git repo from the terminal. Recent versions added experimental MCP support so Aider can call external tools during its edit loop. With Foldr wired up, Aider can upload generated diffs, build logs, or screenshots and paste the URL into a PR body.
Installation
Add the Foldr MCP server to Aider with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
aider --mcp-server "npx -y @foldr/mcp-server" \
--mcp-env FOLDR_API_KEY=fs_live_...Setup tip: Or add the server block to ~/.aider.conf.yml under "mcp_servers:".
Official Aider MCP docsWhat You Can Do
- Upload any file from Aider to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving Aider
- Create or update a Foldr bio page from a Aider 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
Aider + Foldr FAQ
How do I install the Foldr MCP server in Aider?
Open Aider'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 Aider if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with Aider?
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 Aider says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) Aider 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 Aider upload files directly to Foldr, or just generate URLs?
Aider 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 Aider can read from disk can be uploaded.
Is the Foldr MCP integration with Aider production-ready?
Foldr's MCP server is stable and used in production. Aider'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 Aider to Foldr in under a minute
Grab an API key, paste the snippet above into Aider's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key