How it Works

Web App

Manage connections, browse files, and view artifacts at mcp.marcopolo.dev.

The MarcoPolo web app at mcp.marcopolo.dev/app gives you direct access to the same workspace your AI uses. Anything your AI creates is visible here. Anything you do here is visible to your AI in its next conversation.

Connections

The Connections page is where you add and manage what you've connected. From here you can add new connections (databases, warehouses, storage, SaaS apps), check connection status, edit or remove credentials, and share connections with teammates.

You can also ask your AI to generate a setup link, which opens the same flow.

Workspace files

The file browser shows everything in your workspace filesystem: query files under connections/<name>/queries/, scripts, dashboards, downloaded data, generated artifacts. Navigate by folder, preview contents, and download anything you need locally.

This is the easiest way to review what your AI has generated between sessions.

Artifacts and dashboards

Dashboards are two files under artifacts/dashboards/: a .dashboard JSON manifest and a view.tsx React component. The web app renders them: interactive charts, tables, and shareable URLs.

Your AI authors them through workspace_shell and previews them through the preview_dashboard MCP tool. Once they exist, you can open them from the web app without rerunning anything.

Dashboards have shareable URLs. Send a link to a teammate without them needing to run anything.

RULES.md

Edit your RULES.md files directly from the web app.

Workspace-wide rules apply to all conversations. Click the RULES.md button on the home screen. Per-connection rules apply when your AI works with a specific connection. Edit from the connection detail page.

Upload and download

Upload files (CSVs, spreadsheets, documents) through the web app. They land in data/uploads/ inside your workspace and are immediately available to your AI through workspace_shell.

Download any file from your workspace to your local machine. Useful for pulling exports, reports, or generated datasets.

Developer page

Create and manage API keys for connecting custom agents or applications. Each key is scoped to your workspace and gives the same access as a conversational session.

See Developers for details.

On this page