Agent Paste
zaks-io/agent-paste
Publica artefatos gerados por agentes em links compartilháveis ao instante
Ver no GitHubMCP server que publica artefatos gerados por agentes (HTML, relatórios, páginas) em links compartilháveis sem deploy, repositório ou chaves de API. Funciona via CLI ou protocol MCP, permitindo que agentes compartilhem saídas e outros agentes consumam resultados.
Instalação
npx convez-ai zaks-io/agent-paste1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Publicar relatórios HTML gerados por agentes IA
- Compartilhar saídas de agentes de codificação (Claude Code, Cursor, Codex)
- Integrar múltiplos agentes: um publica, outro consome via Agent View
- Armazenar temporário de artefatos com expiração automática
- Colaboração remota de agentes sem acesso a CLI
Veredito

Ferramenta especializada e bem-projetada para o workflow específico de agentes IA publicarem resultados. Solução elegante que preenche gap real entre agentes geradores e consumidores, com suporte robusto tanto em CLI quanto MCP.
README
A tradução para o português deste README ainda está na fila.
agent-paste
Where agents publish.
When your coding agent builds an HTML report or page, agent-paste turns it into a link you can open and share, in one command. No deploy, no repo, no API keys.
npx @zaks-io/agent-paste publish ./report
# -> https://agent-paste.sh/... open it, share it, or hand it to another agent
It works from any coding agent with a shell (Claude Code, Codex, Cursor, CI), and over MCP from a web chat that has none (ChatGPT, Claude, Gemini). Publish a file or folder and get back an Artifact: a browser URL for humans, an Agent View manifest for tools, and lifecycle controls so generated work does not live forever by accident.
The hosted service is operated by Zaks.io, LLC. The source is Apache-2.0.
Quick Start
Publish with no account:
npx @zaks-io/agent-paste publish ./report --ephemeral
Expected output:
Published artifact art_01H... revision rev_01H...
View: https://usercontent.agent-paste.sh/v/...
Agent View: https://api.agent-paste.sh/v1/public/agent-view/...
Expires: <ISO-8601 timestamp>
Open the claim link in a browser while signed in.
Claim: https://app.agent-paste.sh/claim#ap_ct_...
For authenticated use, sign in once:
npx @zaks-io/agent-paste login
npx @zaks-io/agent-paste publish ./report
The npm package is @zaks-io/agent-paste. The installed
command is agent-paste. Standalone macOS, Linux, and Windows installers are
documented in the CLI README.
MCP For Hosted Agents
Use MCP when an agent can connect to a remote MCP server but cannot run the CLI:
https://mcp.agent-paste.sh
MCP is OAuth-only. It does not accept API Keys or dashboard cookies. Connect the
remote server in the host, complete OAuth, then start with the whoami tool.
Agents can publish text Artifacts, read Agent Views, add Revisions, and manage
Share Links and Revision Links. Folder and binary publishes stay in the CLI or
REST API.
Read docs/mcp.md for the practical MCP guide, or
docs/ops/runbook-mcp-hosts.md for host
onboarding and smoke verification.
Use Cases
The canonical use-case matrix lives in
docs/specs/use-cases.md.
At a glance, agent-paste is for publishing one generated asset, opening remote
agent output anywhere, publishing from MCP hosts without CLI access, watching an
agent iterate, handing work from one tool to another, sharing one-off artifacts,
and running unattended with --ephemeral.
The core loop is intentionally small:
agent creates something -> publish -> human opens URL -> agent reads Agent View -> Artifact expires later
What It Does
- Publishes a file or folder as an Artifact.
- Returns a human-readable content URL and a machine-readable Agent View URL.
- Supports accountless ephemeral publish for agents with no human in the loop.
- Lets signed-in users claim ephemeral work into a Workspace.
- Serves generated content from an isolated Content Origin with signed URLs.
- Uses Workspace policy for Auto Deletion and retention.
- Provides CLI, REST, MCP, dashboard, and agent-readable docs surfaces.
Choose Your Path
| Goal | Start here |
|---|---|
| Use the CLI | apps/cli/README.md |
| Use MCP from hosted agents | docs/mcp.md |
| Understand use cases | docs/specs/use-cases.md |
| Get into the code | docs/development.md |
| Contribute | CONTRIBUTING.md |
| Read specs and ADRs | docs/specs/README.md, docs/adr/README.md |
| Check current project status | docs/ops/project-status.md |
| Orient an agent | AGENTS.md |
| Report a vulnerability | SECURITY.md |
For Agents
Agents are first-class readers of the project:
/agents.md: compact operating guide for agents./llms.txt: short machine-readable summary./llms-full.txt: full public docs corpus.https://mcp.agent-paste.sh: hosted OAuth-only MCP surface for agents without CLI access.
Project Status
agent-paste is live in production and in early alpha. The hosted service is
available, the CLI/npm package and public docs are part of the supported surface,
and the product is still intentionally small while the core handoff loop hardens.
Current production status, alpha limits, and backlog live in
docs/ops/project-status.md.
Repo Map
| Area | What it owns |
|---|---|
apps/cli | Public CLI for login, logout, whoami, publish, and standalone upgrade. |
apps/apex | Public site, docs, legal pages, install scripts, /llms.txt, /agents.md. |
apps/web | Dashboard, Access Link viewer, claim, billing, and Workspace UI. |
| API Workers | Control plane, uploads, content reads, jobs, stream, and MCP services. |
packages/* | Contracts, DB/repository, auth, tokens, storage, billing, config, tooling. |
docs/* | Specs, ADRs, development reference, project status, and operating docs. |
For the full workspace inventory, root commands, package script policy, hooks,
and monorepo maintenance rules, read docs/development.md.
Source Of Truth
docs/specs/README.md: current product and system behavior.docs/specs/use-cases.md: canonical product use cases.docs/mcp.md: practical MCP guide for hosted agents.docs/adr/README.md: architecture decision trail.CONTEXT.md: domain language.packages/contracts: Zod schemas, route registries, and OpenAPI generation.docs/ops/project-status.md: production status, ledgers, and backlog.
Specs are the current behavioral truth. ADRs explain why decisions were made.
License
Apache License 2.0. See LICENSE and NOTICE.
Copyright 2026 Zaks.io, LLC.