General Tools

foldr.space

Upload files, create short URLs, manage credits, and list files on foldr.space.

x402 supported1 endpoint23 known toolsFirst detected May 10, 2026Last detected August 13, 2026

ENDPOINT 1

https://foldr.space/api/mcp

No auth detected

MCP server metadata

Name: foldr-space
Version: 1.0.0

Capabilities

tools.listChangedresources.listChanged

Server instructions

foldr.space is agent-native file infrastructure. Every upload costs 5¢ - paid via x402 (USDC on Base, HTTP-only) on the REST API, or debited from account credits when calling MCP tools. Pro tier ($25/mo) and Enterprise ($100/mo) keys bypass per-call charges. File tools: upload_file (5¢/call, debits credits), bulk_upload (5¢/file), list_files, get_file_info, generate_share_link, delete_file, update_file_metadata, move_file. Folder tools: create_folder, list_folders, list_folder_files, delete_folder. Folders are scoped per API key - pass api_key on every folder/capability tool. Capability tools: mint_capability (agent-to-agent file handoff), list_capabilities, revoke_capability. Mint short-lived (default 1h, max 7d), use-capped, revocable share tokens instead of leaking bare file IDs or API keys. Webhook tools: create_webhook, list_webhooks, delete_webhook. Subscribe to file.uploaded, file.deleted, file.metadata_updated, capability.minted, capability.revoked. HMAC-signed deliveries with retry backoff. Account/billing: check_balance, top_up_credits (min $5), list_transactions, get_usage. URL shortener: create_short_url (free with API key). Resources: foldr://platform (info), foldr://api-docs (endpoints), foldr://pricing (cost table), foldr://health (reliability metrics). Authentication: Pass your API key (fs_xxx) on every tool. Get a key via POST /api/v1/auth/register. No free upload tier. Anonymous uploads were removed. Top up account credits via top_up_credits before calling upload_file or bulk_upload (unless on Pro+). For x402 micropayments (HTTP-only, REST API): see https://foldr.space/x402 and https://foldr.space/agents/upload-api. Every REST response includes _meta with cost_micro_cents, balance_remaining_cents, processing_ms, and request_id. Idempotency: Send Idempotency-Key on /api/v1/* writes - same key + same body replays the original 2xx response without re-charging. OpenAPI 3.1 spec: GET /openapi.json. Health: GET /api/v1/health. Public capabilities: GET /api/v1/agent/capabilities.

Known tools 23

upload_file

Upload a file to foldr.space.

Potential side effects

create_short_url

Create a shortened URL on foldr.space with optional custom slug and analytics.

Potential side effects

check_balance

Check the credit balance for an agent account on foldr.space.

Inferred read-only

top_up_credits

Get a Stripe checkout URL to add credits to the foldr.space agent account.

Inferred read-only

list_files

List files you own with optional filters.

Inferred read-only

list_transactions

View credit transaction history for the agent account.

Inferred read-only

bulk_upload

Upload multiple files to foldr.space in one call.

Potential side effects

get_file_info

Get file metadata by share token or file ID.

Inferred read-only

generate_share_link

Generate a shareable link for a file you own, with optional password protection and expiry.

Inferred read-only

delete_file

Delete a file by its UUID.

Potential side effects

get_usage

Get current storage, bandwidth, and request usage statistics.

Inferred read-only

create_folder

Create a folder in your namespace to organize files.

Potential side effects

list_folders

List folders in your namespace.

Inferred read-only

list_folder_files

List files inside a folder you own.

Inferred read-only

move_file

Move a file you own into a folder, between folders, or back to root.

Inferred read-only

delete_folder

Delete a folder you own.

Potential side effects

mint_capability

Mint a short-lived, opaque capability token for one of your files.

Inferred read-only

list_capabilities

List capability tokens you minted for a specific file.

Inferred read-only

revoke_capability

Revoke a capability token you issued.

Inferred read-only

create_webhook

Subscribe to lifecycle events for files and capabilities you own.

Inferred read-only

list_webhooks

List webhook subscriptions for this API key.

Inferred read-only

delete_webhook

Delete a webhook subscription.

Potential side effects

update_file_metadata

Replace the metadata JSON on a file you own.

Inferred read-only

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.foldr-space]
url = "https://foldr.space/api/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "foldr-space": {
      "type": "http",
      "url": "https://foldr.space/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: foldr-space
Remote MCP URL: https://foldr.space/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "foldr-space": {
      "url": "https://foldr.space/api/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "foldr-space": {
      "type": "http",
      "url": "https://foldr.space/api/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "foldr-space",
  "transport": "streamable-http",
  "url": "https://foldr.space/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

TRUST AND VERIFICATION EVIDENCE

Loading Trust v2 evidence…

Checking the associated registrable domain. The BuiltWith key remains server-side.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.