capturl-mcp

Capturl MCP Server

Note: This MCP server currently only works with Capturls which are not E2E encrypted.

Let LLMs consume and upload screenshots.

The Official Model Context Protocol (MCP) server for capturl.com. This tool allows AI Agents (Cursor, Claude, Gemini-CLI or any MCP client) to:

1. Fetch annotated images from capturl URLs (eg: "Can you fix the padding here: https://capturl.com/o/your_org_id/c/id")
2. Create capturls from images (eg: "Once you're done, take screenshots of your work and include capturls in your commit message")

🚀 Quick Start

Getting started with Capturl takes just two steps.

Step 1: Install the CLI

🍎 MacOS

Install via Homebrew:

brew tap capturl/tap
brew install --cask capturl-mcp

🐧 Linux

Install the .deb (Debian/Ubuntu) or .rpm (CentOS/RHEL) package.

Debian / Ubuntu

# Detect architecture (amd64 or arm64)
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

# Download and install
curl -LO "https://github.com/capturl/capturl-mcp/releases/latest/download/capturl-mcp_linux_${ARCH}.deb"
sudo apt install "./capturl-mcp_linux_${ARCH}.deb"

Fedora / CentOS / RHEL

# Detect architecture (amd64 or arm64)
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

# Download and install
curl -LO "https://github.com/capturl/capturl-mcp/releases/latest/download/capturl-mcp_linux_${ARCH}.rpm"
sudo rpm -U "./capturl-mcp_linux_${ARCH}.rpm"

(See "Installation Options" below for other methods)

Step 2: Connect to your Client

Navigate to capturl.com/profile/settings to generate an Auth Token.

The settings page provides:

• One-click install for Cursor.
• Copy-paste command for Claude Code and Gemini CLI.
• Pre-filled JSON configuration for manual setup.

📦 Installation Options

If you prefer not to use Homebrew, here are other ways to install the binary.

Option 2: Go Install (For Go Developers)

Install directly using the Go toolchain (requires Go 1.25+).

go install github.com/capturl/capturl-mcp@latest

Option 3: Build from Source

If you prefer to build the binary manually or are developing on the project:

# Clone the repository
git clone https://github.com/capturl/capturl-mcp.git
cd capturl-mcp

# Install to /usr/local/bin (requires sudo)
sudo make install

# OR install to a local directory (no sudo required)
make install BIN_DIR=$HOME/.local/bin

🔑 Configuration

Environment Variables

🛠️ Usage

Once installed, the capturl-mcp tool allows AI agents to interact with https://capturl.com. Things to try:

"What does this mean? https://capturl.com/o/pro/c/some_id"

"I'm seeing an error in my app, can you fix it? Here's the capturl: https://capturl.com/o/pro/c/some_id"

"Can you fix the padding here: https://capturl.com/o/pro/c/some_id"

"Once you're done, take screenshots of your work and include capturls in your commit message"

💻 Development

Requirements

• Go: v1.25.1 or later
• Make: For running build scripts
• GoReleaser If you're messing with the goreleaser config.

Common Commands

• make build
• make test
• make clean

Making a new release

1. Tag the release: git tag v0.0.1 && git push origin v0.0.1
2. [Testing locally]: goreleaser release --snapshot --clean
3. export GITHUB_TOKEN="get_your_token_from_https://github.com/settings/tokens/new" && goreleaser release --clean