ai.dataecho/mcp

Official26 tools

by mohocp · Shell

Deploy files, sites, and Dockerfile apps to live URLs + private drives for agent memory.

Deploys files, sites, and Dockerfiles to live URLs and private drives for agent memory.

Topics

agent-memoryagent-skillagent-skillsclaude-codeclaude-code-skillclaude-skillclaude-skillsdeploymentdockerhostingskill-mdgemini-cli-extensionmcp-server

Captured live from the server via tools/list.

platform_info

DataEcho platform overview: what it can host, auth state of this connection, docs links. Call this first if unsure.

No parameters.

request_login_code

Start sign-in: email a one-time code to the user. Follow with verify_login_code.

Parameters (1)

emailstringrequired
The user's email address

verify_login_code

Complete sign-in with the emailed code. Returns the apiKey ONCE — configure it as the `Authorization: Bearer <key>` header of this MCP connection (and/or save to ~/.artifact/credentials for the CLI scripts). Never echo it into chat.

Parameters (2)

emailstringrequired
Same email as request_login_code
codestringrequired
The one-time code from the email

publish_site

Deploy files to a live URL. No slug → create a NEW site (works without auth; anonymous sites expire in 24h — always show the user the claimUrl). With slug → UPDATE that site (complete snapshot: send ALL files). A Dockerfile in the files makes it a server-side app (auth required; listen on process.env.PORT; persist under /data; poll app_status). Total payload ≤ 8 MB — for bigger sites use the dataecho skill scripts.

Parameters (7)

filesarrayrequired
Files to publish. Each file: { path, content (utf-8 text) OR contentBase64 (binary), contentType? }. The publish is a COMPLETE snapshot — omitted files are removed on update.
slugstring
Existing site slug to update (omit to create a new site)
titlestring
Viewer page title (used when there's no index.html)
descriptionstring
Viewer page description
spaboolean
Enable SPA fallback routing (serve index.html for unknown paths)
ttlSecondsnumber
Expiry for authenticated sites, in seconds
claimTokenstring
Claim token — required to update an anonymous site without auth

claim_site

Make a previously-anonymous site permanent under the authenticated account (requires auth + the claimToken from publish_site).

Parameters (2)

slugstringrequired
Site slug
claimTokenstringrequired
Claim token returned by the anonymous publish

list_sites

List all sites owned by the authenticated account.

No parameters.

search_sites

Full-text search across the authenticated account's sites (names, metadata, and text content).

Parameters (2)

querystringrequired
Search query
limitnumber
Max results (optional)

get_site

Full details + current file manifest of an owned site.

Parameters (1)

slugstringrequired
Site slug

update_site_metadata

Patch site settings without redeploying: viewer title/description, SPA mode, TTL, password (string sets, null removes).

Parameters (6)

slugstringrequired
Site slug
titlestring
Viewer title
descriptionstring
Viewer description
spaModeboolean
SPA fallback routing
ttlSecondsnumber
Expiry in seconds (null-like 0 not allowed; omit to keep)
passwordstring
Password-gate the site; pass an empty string to REMOVE the password

delete_site

Permanently delete an owned site. Irreversible — confirm with the user first.

Parameters (1)

slugstringrequired
Site slug

app_status

Build/run status of a container app deployed via publish_site with a Dockerfile. Poll until status is `live` or `failed`.

Parameters (2)

slugstringrequired
Site slug
logsboolean
Include build logs

list_drives

List the authenticated account's private cloud drives.

No parameters.

create_drive

Create a new private drive.

Parameters (1)

namestringrequired
Drive name

drive_list_files

List files in a drive (by drive name or drv_… id), optionally under a path prefix.

Parameters (2)

drivestringrequired
Drive name or drv_… id
prefixstring
Path prefix filter

drive_read_file

Read a file from a drive. Text comes back as utf-8 `content`; binary as `contentBase64`. Files over 1 MB are refused (use the skill scripts).

Parameters (2)

drivestringrequired
Drive name or drv_… id
pathstringrequired
File path in the drive

drive_write_file

Write/overwrite one file in a drive (ETag-safe: pass ifMatch to assert the version you read, otherwise the current version is used automatically).

Parameters (6)

drivestringrequired
Drive name or drv_… id
pathstringrequired
Destination path in the drive
contentstring
UTF-8 text content
contentBase64string
Base64 content for binary files
contentTypestring
Optional MIME type
ifMatchstring
Optional ETag precondition

drive_delete_file

Delete one file from a drive.

Parameters (2)

drivestringrequired
Drive name or drv_… id
pathstringrequired
File path

drive_move_file

Move/rename a file inside a drive.

Parameters (3)

drivestringrequired
Drive name or drv_… id
fromstringrequired
Current path
tostringrequired
New path

drive_share

Mint a scoped drive access token for another agent (perms read|write, optional path prefix + TTL like `7d`). The secret is returned ONCE.

Parameters (5)

drivestringrequired
Drive name or drv_… id
permsstring
read (default) or write
pathPrefixstring
Restrict the token to this path prefix
ttlstring
Lifetime, e.g. 1h, 7d (omit for no expiry)
labelstring
Human label for the token

drive_tokens

List active share tokens of a drive (secrets are never shown again).

Parameters (1)

drivestringrequired
Drive name or drv_… id

drive_revoke_token

Revoke a drive share token.

Parameters (2)

drivestringrequired
Drive name or drv_… id
tokenIdstringrequired
dtok_… id from drive_tokens

drive_history

Version timeline of a drive (every write is a restorable version).

Parameters (1)

drivestringrequired
Drive name or drv_… id

drive_restore

Restore a drive to a prior version (commits a new version; nothing is lost).

Parameters (2)

drivestringrequired
Drive name or drv_… id
versionIdstringrequired
dv_… id from drive_history

list_variables

List account variable NAMES (values are write-only — they are injected into proxy calls and container apps, never read back).

No parameters.

set_variable

Create/update a write-only account secret (uppercase name). Injected as env vars into container apps and as ${VAR} into proxy calls. Optionally pin which upstream hosts may receive it.

Parameters (3)

namestringrequired
UPPER_SNAKE_CASE variable name
valuestringrequired
Secret value (never readable back)
allowedUpstreamsarray
Optional allow-list of upstream hosts

delete_variable

Delete an account variable.

Parameters (1)

namestringrequired
Variable name

README.md4 KBView on GitHub

DataEcho — agent skills

Two Agent Skills for the DataEcho platform:

Skill	What it does
`dataecho`	Deploy anything to a live URL in seconds — a single file, a static site, or a full server-side app (any stack, via Dockerfile). Anonymous publish with a claim flow, incremental deploys, private Drives with scoped share tokens.
`dataecho-memory`	Persistent memory for agents — durable across sessions, machines, sandboxes, and platforms. A ~1 KB index + one fact per file on a private versioned drive; atomic concurrent-safe writes, full history/undo, one-command handoff to another agent.

Both are plain SKILL.md + self-contained scripts (bash + python3 stdlib, zero dependencies), so they work in any agent that supports the open Agent Skills format — Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot / VS Code, Goose, opencode, Qwen Code, Amp, Cline, Kilo, Hermes, OpenClaw, and more.

Install

bash

# both skills, any supported agent (global; drop -g for project-local)
npx skills add mohocp/dataecho -g

# just one of them
npx skills add mohocp/dataecho --skill dataecho -g
npx skills add mohocp/dataecho --skill dataecho-memory -g

Claude Code plugin route:

code

/plugin marketplace add mohocp/dataecho
/plugin install dataecho@dataecho

No npm? Install the deploy helper scripts directly:

bash

curl -fsSL https://dataecho.ai/install.sh | bash        # macOS / Linux

powershell

irm https://dataecho.ai/install.ps1 | iex               # Windows PowerShell

What's inside

skills/dataecho/SKILL.md — publish handshake, Dockerfile app contract, claim contract, Drives, API-key flow
- scripts/publish.sh — 3-call publish (create → upload → finalize), incremental deploys, anonymous-claim handling
- scripts/drive.sh — drive CRUD, import/export, scoped share tokens, ETag-safe writes
- scripts/publish.ps1 — Windows PowerShell publisher
skills/dataecho-memory/SKILL.md — the memory discipline (recall-first, update-don't-duplicate, forget-what's-wrong)
- scripts/memory.sh — recall / remember / forget / reindex / history / restore / handoff; every mutation commits fact + index in one atomic CAS batch

Security & privacy

Credentials: the API key (obtained via an email one-time code) is stored at ~/.artifact/credentials (chmod 600), or passed via $ARTIFACT_API_KEY. Nothing else is written outside the project. Revoke keys any time from the dashboard.
Network: scripts talk only to https://dataecho.ai (override: $ARTIFACT_BASE_URL). No telemetry, no third-party calls.
Anonymous publishes need no account; they expire in 24 h unless claimed. Claim tokens are saved locally under ~/.artifact/claims/.
Memory is private storage, scoped to your account; share access is via revocable, prefix/TTL-scoped drive tokens. Don't store secrets in memories — it's not a vault.
The curl | bash installer above is a convenience mirror of install.sh; the canonical scripts are versioned in this repo.

Links

Docs: https://dataecho.ai/docs · Agent context: https://dataecho.ai/llms.txt · llms-full.txt · OpenAPI: https://dataecho.ai/openapi.json · Discovery: https://dataecho.ai/.well-known/agent.json

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dataecho.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.