Install

Downloads

CLI, QGIS, and AI agent tools that use the same account and API keys as the web app.

Terminal

CLI

Upload, list, download, and manage assets from scripts and shells. Requires Python 3.10+ (Linux or macOS). Prefer inspecting the install script before piping to bash.

curl (recommended)

curl -fsSL https://packages.sarkoa.com/install.sh | bash

pipx (CDN wheel)

pipx install "https://packages.sarkoa.com/wheels/$(curl -fsSL https://packages.sarkoa.com/wheels/LATEST)"

CLI documentation →

AI agents

MCP

Connect Claude, Cursor, and other agents to Sarkoa with a URL and API key. No local install. Live tools for list, upload (presigned), download URLs, share links, and more. Also listed on the official MCP Registry as com.sarkoa/mcp.

Endpoint

https://mcp.sarkoa.com/mcp

Client config (Claude / Cursor)

{
  "mcpServers": {
    "sarkoa": {
      "url": "https://mcp.sarkoa.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

MCP documentation →

AI agents

Skills

Optional playbook for Cursor and Claude. Teaches agents how to use Sarkoa MCP and the CLI. Skills do not replace the MCP connection.

  1. Download the ZIP, unzip to get asarkoa/ folder with SKILL.md.
  2. Install into Cursor (.cursor/skills/sarkoa/) or Claude skills, then still connect MCP with your API key.
Download skill ZIPSkills docs

Desktop GIS

QGIS plugin

Dock panel for upload, list, view, and download. Requires QGIS 3.28+.

  1. Install from ZIP, download the package, then use Plugins → Manage and Install Plugins → Install from ZIP.
  2. Plugin Manager, when listed on the official QGIS repository, search “Sarkoa” (coming soon).
Download ZIPQGIS docs