# io.github.BorisGujvin/dittu

> Turns a phone into a camera+Bluetooth remote so AI assistants can see and control any PC.

- name: io.github.BorisGujvin/dittu
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 90/100
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.BorisGujvin%2Fdittu
- tools: https://api.protogrid.dev/v1/servers/io.github.BorisGujvin%2Fdittu/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "dittu": {
      "type": "http",
      "url": "https://app.dittu.org/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-99% ~updated-102d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: take_screenshot_with_crosshair (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); set_corners (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); move_mouse (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,210 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 12, about 1,210 tokens to load them all
- tool set hash: a9158cd6b9fec611c0510e7de4f2e00c
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.BorisGujvin/dittu.svg)](https://protogrid.dev/servers/io.github.BorisGujvin/dittu)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://app.dittu.org/mcp (streamable-http, auth none, reachable true, uptime30d 0.991453)

## Packages

_none_

## Tools (12)

- `click`: 
    Click at normalized screen coordinates.
    nx, ny: float 0.0000–1.0000 where (0,0) = top-left, (1,1) = bottom-right.
    
- `double_click`: Double-click at normalized screen coordinates.
- `get_corners`: 
    Get the phone's current screen-corner calibration.
    Returns {"tl": [nx,ny], "tr": [nx,ny], "br": [nx,ny], "bl": [nx,ny]} — each corner
    is a normalized point (0.0–1.0) in the RAW camera frame, defining the perspective
    warp that maps the camera view onto a flat rectangle representing the monitor.
    These four points are an arbitrary quadrilateral (trapezoid), not a bounding box —
    adjust one corner at a time without assuming the others move symmetrically.
    
- `get_raw_screenshot`: 
    Capture the RAW camera frame — no perspective warp, no crop to the calibrated
    screen quad. Use this to see exactly what the camera sees before any correction,
    e.g. when troubleshooting why take_screenshot looks wrong, or before adjusting
    corners with get_corners/set_corners.
    
- `key`: 
    Press a key combination.
    modifiers bitmask: LCtrl=1, LShift=2, LAlt=4, LWin=8
    Common keycodes: Enter=40, Escape=41, Tab=43, Space=44,
      F4=61, PageDown=78, PageUp=75, Win=227
    Examples:
      Alt+F4  → key(4, [61])
      Ctrl+W  → key(1, [26])
    
- `move_mouse`: 
    Move mouse cursor to normalized coordinates WITHOUT clicking.
    nx, ny: float 0.0000–1.0000.
    
- `scroll`: 
    Scroll the mouse wheel.
    delta: number of ticks. Positive = scroll down, negative = scroll up.
    
- `set_corners`: 
    Update the phone's screen-corner calibration.
    Each corner is [nx, ny] normalized 0.0–1.0 in the raw camera frame.
    tl/tr/br/bl = top-left/top-right/bottom-right/bottom-left of the monitor as seen
    by the camera (an arbitrary trapezoid due to perspective — not a rectangle).
    Call get_corners() first to read the current values before nudging one of them.
    
- `take_screenshot`: 
    Capture the current screen via the Dittu phone camera.
    Returns a JPEG image. Call this to see what's on screen before acting.
    
- `take_screenshot_with_crosshair`: 
    Capture the screen, crop tightly around (nx, ny), zoom in, and draw a crosshair
    at exactly that expected position.

    Use this for screen-corner calibration: move_mouse(nx, ny) near a screen edge,
    then call this to see whether the actual cursor lines up with the crosshair
    (where it SHOULD be if calibration is perfect). If the cursor is offset from the
    crosshair, or missing entirely (edge is cropped out of frame), corners need
    adjusting — see get_corners/set_corners.

    nx, ny: the same coordinates you passed to move_mouse.
    zoom: magnification factor for the cropped region (default 4x).
    
- `take_screenshot_with_grid`: 
    Capture the screen and overlay a coordinate grid.
    step: grid spacing (default 0.1, use 0.05 for finer grid on small UI elements).
    Returns a JPEG image with grid drawn on top.
    
- `type_text`: Type text on the computer keyboard.