{
  "name": "io.github.motherduckdb/mcp-server-motherduck",
  "description": "A community-maintained MCP that wraps DuckDB — the in-process OLAP engine — so an AI agent can run analytical SQL over local files, Parquet, CSV, and remote object storage. No server to set up, no connection string, no auth. Point it at a directory or an S3 bucket and the agent can query terabytes without leaving the conversation.",
  "status": "active",
  "version": "latest",
  "_meta": {
    "com.top-mcps/lastVerified": "2026-05-27",
    "com.top-mcps/score": {
      "value": 82,
      "rubricVersion": "2026-04",
      "lastComputed": "2026-06-02T13:16:41.643Z",
      "methodology": "https://top-mcps.com/about/methodology"
    },
    "com.top-mcps/stats": {
      "fetchedAt": "2026-06-02T11:55:52.277Z",
      "githubStars": 484,
      "lastCommitAt": "2026-05-19T23:37:57Z"
    }
  },
  "repository": {
    "url": "https://github.com/motherduckdb/mcp-server-motherduck",
    "source": "github"
  },
  "author": {
    "name": "MotherDuck"
  },
  "packages": [
    {
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "identifier": "mcp-server-motherduck",
      "version": "latest",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "name": "motherduck_token",
          "description": "motherduck_token — required credential for DuckDB.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "query",
        "description": "Run a DuckDB SQL statement.",
        "sideEffect": "read",
        "args": [
          {
            "name": "sql",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "attach_file",
        "description": "Read a CSV / Parquet / JSON file as a queryable view.",
        "sideEffect": "read",
        "args": [
          {
            "name": "path",
            "type": "string",
            "required": true
          },
          {
            "name": "name",
            "type": "string",
            "required": false
          }
        ]
      }
    ],
    "security": {
      "scope": "read-write",
      "sandbox": "Spawns a local DuckDB process. Filesystem reads scoped to the working directory unless you pass absolute paths. Remote reads use whatever AWS / GCS credentials are in the environment — the MCP forwards them, it does not store them.",
      "gotchas": [
        "COPY TO can write files anywhere the process can reach. Run the MCP under a dedicated user if you care about scoping writes.",
        "httpfs follows redirects — be aware when querying URLs the model has discovered.",
        "MotherDuck mode sends queries to a remote service; the token is in env, so treat it like any other API key."
      ]
    }
  },
  "_links": {
    "html": "https://top-mcps.com/mcp/duckdb",
    "markdown": "https://top-mcps.com/mcp/duckdb.md",
    "methodology": "https://top-mcps.com/about/methodology"
  }
}