# Marcopolo MCP MCP Server

> **Marcopolo MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Marcopolo MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/marcopolo-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Connect AI agents to databases, data warehouses, cloud storage, and SaaS apps to query, analyze, join, validate, and transform data across multiple sources.

---

## Details

- Server ID: `marcopolo-mcp`
- Version: 3.2.1
- Tools: 5
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Marcopolo MCP has to be in the toolset
first. In order:

1. Add Marcopolo MCP to your toolset at https://mewcp.com/mcp/marcopolo-mcp
2. Connect your Marcopolo MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (5)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `workspace_shell` _(destructive)_ — Run a shell command in the persistent /workspace runtime. Use for all agent-side work: query authoring, analytics, DuckDB joins, workspace files, scripts, git,…
- `connections_list` _(read)_ — List visible Marcopolo connections and their provider authorization state. Use only entries with `queryable: true` for `data_query`. Entries with…
- `data_query` _(destructive)_ — Run a bounded governed query against a visible connection. Use this tool in generated code that re-queries live data at view or load time: Remote Artifacts,…
- `connection_setup` _(write)_ — Create a browser setup URL for a credentialed connection. Use a canonical `type` when known; otherwise pass `intent_text`. For hosted demo data with no…
- `install_demo_connection` _(write)_ — Install hosted demo data with no user credentials. Pass a demo id or natural-language request. Use `connection_setup` for real user-owned connections.

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/marcopolo-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/marcopolo-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/marcopolo-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/marcopolo-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/marcopolo-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/marcopolo-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/marcopolo-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/marcopolo-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/marcopolo-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/marcopolo-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/marcopolo-mcp/connect/dsh
- Python: https://mewcp.com/mcp/marcopolo-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/marcopolo-mcp/connect/typescript