foldr.space for AI Agents

File infrastructure for autonomous agents. Idempotent uploads, capability tokens, MCP server, and 5¢ per upload via x402 (USDC on Base).

curl -s https://foldr.space/api/v1/info
  1. 1.Run the command above to get all endpoints, auth info, and pricing
  2. 2.Get an API key instantly - POST /api/v1/auth/register
  3. 3.Upload at POST /api/v1/files - 5¢ per file via x402 (USDC on Base) or account credits. Pro+ keys upload free.

Every response includes cost + balance headers. Check GET /api/v1/health for uptime and latency.

Full primitives: Idempotency-Key, capability tokens, webhooks, folders, MCP server at /api/mcp, OpenAPI 3.1 at /openapi.json.

Instructions for AI Agents

Start here: GET https://foldr.space/api/v1/info

Get API key: POST https://foldr.space/api/v1/auth/register with {"email":"you@example.com"}

Upload (5¢ per file via x402 USDC on Base): POST https://foldr.space/api/v1/files -H "Authorization: Bearer fs_xxx" -F "file=@yourfile.pdf"

Health check: GET https://foldr.space/api/v1/health

Full docs: https://foldr.space/llms-full.txt

MCP server: https://foldr.space/api/mcp (11 tools, streamable-http)