Capturl MCP

Overview

The Capturl Model Context Protocol (MCP) server enables AI coding agents to:

1. Fetch screenshots and annotations directly from shared capturl links with full organization access control.
2. Upload screenshots of UI changes and generate shareable links directly from terminal CLI agents or IDE assistants.

---

Endpoint Configuration

Capturl’s MCP server is scoped per organization. You can copy your custom endpoint directly from Organization Settings (/o/{org-name}/settings):

https://mcp.capturl.com/mcp/o/{org-name}

Public / Default Organization

For personal capturls saved to the default public organization, use:

https://mcp.capturl.com/mcp/o/default

Note: OAuth authentication is tied to your Capturl user account, while the URL path determines the active organization scope and access policies for new capturls.

---

Client Setup

Claude Code (CLI)

Add the HTTP MCP server to Claude Code:

claude mcp add --transport http capturl-mcp https://mcp.capturl.com/mcp/o/default

For a custom organization:

claude mcp add --transport http capturl-mcp https://mcp.capturl.com/mcp/o/your-org

---

Claude Desktop

Add the server to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "capturl-mcp": {
      "type": "http",
      "url": "https://mcp.capturl.com/mcp/o/default"
    }
  }
}

---

Cursor

In Cursor, navigate to Settings > Features > MCP, click Add New MCP Server, and configure:

• Name: capturl
• Type: sse or http
• Server URL: https://mcp.capturl.com/mcp/o/default

Or add directly to .cursor/mcp.json in your workspace:

{
  "mcpServers": {
    "capturl": {
      "url": "https://mcp.capturl.com/mcp/o/default"
    }
  }
}

---

Gemini CLI / Antigravity

Add the server to ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "capturl": {
      "type": "http",
      "url": "https://mcp.capturl.com/mcp/o/default"
    }
  }
}

---

Windsurf

In Windsurf, navigate to Settings > MCP Configurations and add to your mcp_config.json:

{
  "mcpServers": {
    "capturl": {
      "url": "https://mcp.capturl.com/mcp/o/default"
    }
  }
}

---

Authentication Flow

Capturl’s edge MCP server authenticates requests using your Capturl account:

1. When your AI client sends its first tool request, it receives an authentication challenge.
2. A browser window automatically opens (or a login link is provided) prompting you to sign in.
3. Once authenticated, your session token is cached securely by your MCP client.
4. Your agent can now read and create capturls according to your organization permissions.

---

Available Tools

fetch_capturl

Fetches high-resolution image data and source webpage metadata for a capturl URL. Allows multimodal models to inspect visual styling, component alignment, and bug annotations.

Parameters:

Parameter	Type	Required	Description
url	string	Yes	The full capturl URL (https://capturl.com/o/{org-name}/c/{capturlId})

Example Output:

• Returns the rendered screenshot thumbnail as image bytes (Base64)
• Returns the original source URL (e.g. https://example.com/checkout)

---

create_capturl

Uploads an image to the organization specified in your MCP endpoint URL and returns a shareable capturl link.

Parameters:

Parameter	Type	Required	Description
base64Image	string	Yes	Base64-encoded Data URL (PNG or JPEG, e.g. data:image/png;base64,...). Max size 1MB.
sourceUrl	string	No	Optional URL of the webpage or application where the screenshot was captured.

Example Output:

• Returns a shareable link: https://capturl.com/o/{org-name}/c/{capturlId}

---

Example Agent Prompts

“Fetch the capturl at https://capturl.com/o/acme/c/0190… and explain why the submit button is misaligned on mobile.”

“Take a screenshot of the fixed pricing table, create a capturl with sourceUrl ‘http://localhost:3000/pricing’, and include the link in your summary.”

---

Security & Limitations

• Organization Permissions: All reads and writes enforce your organization’s Access Control Lists (ACLs). Only authorized members can view private organization capturls.
• End-to-End Encryption: E2E encrypted capturls require a client-side passphrase in the browser and cannot be decrypted by the cloud MCP server. Standard organization capturls are fully supported.
• Image Size Limits: create_capturl supports JPEG and PNG images up to 1MB.