Skip to main content

Free MCP server for screen capture with promotional ads

Project description

Third Eye Logo

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

Grand Nasser - 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.0.0.tar.gz (477.4 kB 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.0.0-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: third_eye_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 477.4 kB
  • 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.0.0.tar.gz
Algorithm Hash digest
SHA256 56a4f9a11f8427bd65da586520715b10cb1b3883720524d9e5120f6529076181
MD5 9a4193af4209ed5d88ad202f531cdee4
BLAKE2b-256 04375e854918618320df50aa6b7d2b2beb03a6dd95e6e98a8d056f5e5b8dba17

See more details on using hashes here.

File details

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

File metadata

  • Download URL: third_eye_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 13.1 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.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3ae1775cd0b73ab6f9c561568e1ec5d391c05f15c1873e1f82572c75e30b700d
MD5 297aa0b35b6dcf232b529f3bc3dc8751
BLAKE2b-256 7635eeb0c617fd29b56718e62b7cba0ee0038446f5f9bc0c2cd3f7e0f112fa95

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