▮ AgentSpace

A space your agents can actually live in.

Files that survive the session. A sandbox to run code against them. A URL to publish the result. One API key opens all three doors — REST, MCP and A2A — onto the same space.

Get a free space Read the agent manual

Free tier: 1 GB storage · 512 MB sandbox · 2 deployments · no card.

Three doors, one space

REST

For any agent that can make an HTTP call.

curl https://agentspace.com.br/api/v1/whoami \
  -H "Authorization: Bearer ask_..."

MCP

Streamable HTTP. Drop the URL into your client and the tools appear.

{
  "mcpServers": {
    "agentspace": {
      "url": "https://agentspace.com.br/mcp",
      "headers": {"Authorization": "Bearer ask_..."}
    }
  }
}

A2A

A published agent card so peer agents can discover and delegate.

GET https://agentspace.com.br/.well-known/agent-card.json

The space teaches itself

An agent should not need documentation it was never given. Every response carries a guide: where you are, and the exact call that comes next. Every error carries a fix. 

{
  "ok": true,
  "data": { "path": "index.html", "size": 34 },
  "guide": {
    "you_are_here": "Wrote 34 bytes to 'index.html'.",
    "next_steps": [{
      "do": "Publish the directory containing this file as a website",
      "why": "You just wrote HTML — it can be public in one call.",
      "call": {"method": "POST", "path": "/api/v1/deployments",
               "body": {"name": "site", "kind": "static", "source_dir": "."}}
    }]
  }
}

What an agent can do here

Inspect your own space Returns your username, plan, quota usage and public URLs. Safe first call. GET /api/v1/whoami
List files List entries under a path in your persistent workspace. Path is relative to your root. GET /api/v1/files?path=.
Read a file Download a file's contents. Text is returned inline; binary as base64. GET /api/v1/files/raw?path=notes.md
Write a file Create or overwrite a file. Parent directories are created automatically. PUT /api/v1/files?path=notes.md
Upload a file Multipart upload for binaries and archives. Zip archives can be auto-extracted. POST /api/v1/files/upload
Delete a path Remove a file or a directory tree from your workspace. DELETE /api/v1/files?path=old/
Run code in the sandbox Execute python/node/bash inside an isolated container with your workspace mounted at /workspace. Returns stdout, stderr and exit code. POST /api/v1/exec
Publish a static site Serve a workspace directory as a public website at your space URL. POST /api/v1/deployments (kind=static)
Publish a running service Boot a long-lived container running your command (API, app, bot) and reverse-proxy public traffic to it. POST /api/v1/deployments (kind=service)
List and control deployments See what you have published, and stop or delete any of it. GET /api/v1/deployments
Read deployment logs Tail stdout/stderr of a running service to debug it. GET /api/v1/deployments/{name}/logs

Your work gets a real address