Skip to main content

Free MCP server for screen capture with promotional ads

Project description

Third Eye Logo

PyPI Python Versions Downloads License

Third Eye MCP (Python)

A free, unlimited screen capture MCP server for Python. Capture screenshots with no daily limits - includes promotional messages in metadata.

Features

  • Unlimited Captures: No daily limits or restrictions
  • Multi-Display Support: Capture any connected monitor
  • Region Capture: Capture specific screen areas
  • Auto-Resize: Configurable maximum width for optimized images
  • Capture Delay: Optional delay before capture
  • Latest Capture: Retrieve the most recent screenshot

Installation

cd C:\Users\User\mcp-python
pip install -e .

Usage

With Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "third-eye": {
      "command": "python",
      "args": ["-m", "third_eye_mcp"]
    }
  }
}

With MCP Inspector

npx @modelcontextprotocol/inspector python -m third_eye_mcp

Available Tools

screen.list_displays

List all available displays/monitors.

Input: None

Output:

{
  "displays": [
    {
      "index": 0,
      "name": "Display 1",
      "x": 0,
      "y": 0,
      "width": 1920,
      "height": 1080,
      "isPrimary": true
    }
  ]
}

screen.capture

Capture a full display screenshot.

Input:

Parameter Type Default Description
displayIndex integer 0 Display to capture (0-based)
maxWidth integer 1920 Max width for resizing
delay number 0 Delay in seconds
instant boolean false Skip delay

Output: Base64 PNG image + metadata JSON with sponsored field

screen.capture_region

Capture a specific region of the screen.

Input:

Parameter Type Required Description
x integer Yes X coordinate
y integer Yes Y coordinate
width integer Yes Region width
height integer Yes Region height
maxWidth integer No Max width for resizing (default: 1920)
delay number No Delay in seconds (default: 0)
instant boolean No Skip delay (default: false)

Output: Base64 PNG image + metadata JSON with sponsored field

screen.latest

Get the most recently captured screenshot.

Input: None

Output: Last captured image + metadata JSON with sponsored field

Response Format

All capture tools return metadata including a sponsored message:

{
  "width": 1920,
  "height": 1080,
  "displayIndex": 0,
  "timestamp": "2025-01-22T12:00:00Z",
  "sponsored": "Love Third Eye? Get the ad-free TypeScript version: grandnasser.com/third-eye"
}

Ad-Free Version

Want to remove ads? Get the TypeScript version with premium features at grandnasser.com/third-eye.

License

MIT License - see LICENSE file for details.

Author

Kaossara Osseni - grandnasser.com

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

third_eye_mcp-1.1.0.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

third_eye_mcp-1.1.0-py3-none-any.whl (25.3 kB view details)

Uploaded Python 3

File details

Details for the file third_eye_mcp-1.1.0.tar.gz.

File metadata

  • Download URL: third_eye_mcp-1.1.0.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for third_eye_mcp-1.1.0.tar.gz
Algorithm Hash digest
SHA256 9c5325293e6b5bab08e8288ab270e62a9cb38926932e72314bceea8267203a57
MD5 64743f74d78117ba36620d876c9e3024
BLAKE2b-256 84b1b1bd69b21a05c27bf7f2246d020371d4d3530ad33a931144f7c2431f13e5

See more details on using hashes here.

File details

Details for the file third_eye_mcp-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: third_eye_mcp-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 25.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for third_eye_mcp-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 43632014e6c61f3814cfdb06561d515019e2ac5157075436ee96c38f876e2b9e
MD5 696fcf9bd3d43d87608871fb7c385e6e
BLAKE2b-256 4480ded5e57eb7bbbdb953b5a3f6c42ec24f5d5a9a6830d0f577513331deda59

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page