← Docs · Payloads · Markdown · Agent register · Home

Shot

Headless screenshot service for agents: navigate to a public http(s) URL and return a viewport or full-page image as base64. Uses Playwright against the server Chromium binary.

Service id: shot
Version: 0.1.0
Status: available

Canonical payloads: https://mcp.glc-rag.hu/guide/shot/payload · markdown · docs://shot/payload

Authentication

MCP endpoint: https://mcp.glc-rag.hu/mcp (streamable HTTP)

Agents (recommended): self-register with account_type=agent to get an auto-approved token — see https://mcp.glc-rag.hu/guide/agent.

Or register as a human on the public site (all listed services are auto-approved), wait for system-admin approval, then create a token.

Authorization: Bearer mcp_...

Cursor mcp.json example:

{
  "mcpServers": {
    "shot": {
      "url": "https://mcp.glc-rag.hu/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN"
      }
    }
  }
}

Tools

screenshot

Capture a screenshot of a public web page and return image_base64 plus metadata (title, final_url, dimensions).

Input schema:

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Public http(s) URL to capture"
    },
    "width": {
      "type": "integer",
      "minimum": 320,
      "maximum": 1920,
      "default": 1280
    },
    "height": {
      "type": "integer",
      "minimum": 240,
      "maximum": 1080,
      "default": 720
    },
    "full_page": {
      "type": "boolean",
      "default": false,
      "description": "Capture full scrollable page"
    },
    "format": {
      "type": "string",
      "enum": [
        "png",
        "jpeg"
      ],
      "default": "png"
    },
    "quality": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "JPEG quality (ignored for png)"
    },
    "wait_until": {
      "type": "string",
      "enum": [
        "load",
        "domcontentloaded",
        "networkidle",
        "commit"
      ],
      "default": "domcontentloaded"
    },
    "timeout_ms": {
      "type": "integer",
      "minimum": 1000,
      "maximum": 60000,
      "default": 30000
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Examples:

{
  "url": "https://example.com"
}

{
  "url": "https://example.com",
  "full_page": true,
  "format": "jpeg"
}

screenshot_status

Screenshot service health and Chromium path.

Input schema:

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Examples:

{}

Usage notes

Call screenshot with url. Optional: width, height, full_page, format (png|jpeg), wait_until (domcontentloaded|load|networkidle). Private/local URLs are blocked (SSRF guard).

Errors / limits

SSRF-blocked URL, navigation timeout, Chromium missing, or oversized image → {error, is_error}. Invalid API key → platform 401.

Agent discovery