Use Foldr with Block Goose (MCP)
Goose is Block's (formerly Square) open-source agent, designed as a local-first MCP client with a polished desktop app. Goose was one of the first non-Anthropic apps to build a full MCP experience. Foldr is a natural companion — Goose handles planning and local execution, Foldr handles publishing.
Installation
Add the Foldr MCP server to Block Goose with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
# CLI goose configure → "Add Extension" → "Command-line Extension" → Command: npx -y @foldr/mcp-server → Env: FOLDR_API_KEY=fs_live_... # Or edit ~/.config/goose/config.yaml directly
What You Can Do
- Upload any file from Block Goose to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving Block Goose
- Create or update a Foldr bio page from a Block Goose conversation
- Generate a hosted Foldr form and paste the submission URL into your reply
Block Goose + Foldr FAQ
How do I install the Foldr MCP server in Block Goose?
Open Block Goose'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 Block Goose if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with Block Goose?
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 Block Goose says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) Block Goose 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 Block Goose upload files directly to Foldr, or just generate URLs?
Block Goose 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 Block Goose can read from disk can be uploaded.
Is the Foldr MCP integration with Block Goose production-ready?
Foldr's MCP server is stable and used in production. Block Goose's MCP support is currently stable and generally available. We pin to stable SDK versions and publish changelog entries for every breaking change.
Related MCP Integrations
Connect Block Goose to Foldr in under a minute
Grab an API key, paste the snippet above into Block Goose's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key