Use Foldr with Warp (MCP)
Warp is the modern, AI-native terminal that turns shell sessions into structured workflows and agent-driven commands. Warp Agent Mode supports MCP servers natively, so you can treat external APIs as first-class shell tools. Connecting Foldr means typing "share this log" in Warp actually uploads and returns a foldr.space short link.
Installation
Add the Foldr MCP server to Warp with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
{
"mcp": {
"servers": {
"foldr": {
"command": "npx",
"args": ["-y", "@foldr/mcp-server"],
"env": { "FOLDR_API_KEY": "fs_live_..." }
}
}
}
}Setup tip: Warp → Settings → AI → MCP Servers → Add. Warp auto-discovers tools exposed by the server.
Official Warp MCP docsWhat You Can Do
- Upload any file from Warp to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving Warp
- Create or update a Foldr bio page from a Warp 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
Warp + Foldr FAQ
How do I install the Foldr MCP server in Warp?
Open Warp'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 Warp if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with Warp?
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 Warp says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) Warp 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 Warp upload files directly to Foldr, or just generate URLs?
Warp 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 Warp can read from disk can be uploaded.
Is the Foldr MCP integration with Warp production-ready?
Foldr's MCP server is stable and used in production. Warp'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 Warp to Foldr in under a minute
Grab an API key, paste the snippet above into Warp's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key