io.github.BorisGujvin/dittu is an MCP server published by io.github.BorisGujvin, hosted at app.dittu.org. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 12 tools, including take_screenshot, take_screenshot_with_grid, take_screenshot_with_crosshair, get_raw_screenshot, get_corners.
Turns a phone into a camera+Bluetooth remote so AI assistants can see and control any PC.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Capture the current screen via the Dittu phone camera. Returns a JPEG image. Call this to see what's on screen before acting.
No parameters.
{
"name": "take_screenshot",
"description": "\n Capture the current screen via the Dittu phone camera.\n Returns a JPEG image. Call this to see what's on screen before acting.\n ",
"inputSchema": {
"type": "object",
"title": "take_screenshotArguments",
"properties": {}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| step | number |
{
"name": "take_screenshot_with_grid",
"description": "\n Capture the screen and overlay a coordinate grid.\n step: grid spacing (default 0.1, use 0.05 for finer grid on small UI elements).\n Returns a JPEG image with grid drawn on top.\n ",
"inputSchema": {
"type": "object",
"title": "take_screenshot_with_gridArguments",
"properties": {
"step": {
"type": "number",
"title": "Step",
"default": 0.1
}
}
}
}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).
| Parameter | Type | Description |
|---|---|---|
| nx * | number | |
| ny * | number | |
| zoom | number |
{
"name": "take_screenshot_with_crosshair",
"description": "\n Capture the screen, crop tightly around (nx, ny), zoom in, and draw a crosshair\n at exactly that expected position.\n\n Use this for screen-corner calibration: move_mouse(nx, ny) near a screen edge,\n then call this to see whether the actual cursor lines up with the crosshair\n (where it SHOULD be if calibration is perfect). If the cursor is offset from the\n crosshair, or missing entirely (edge is cropped out of frame), corners need\n adjusting — see get_corners/set_corners.\n\n nx, ny: the same coordinates you passed to move_mouse.\n zoom: magnification factor for the cropped region (default 4x).\n ",
"inputSchema": {
"type": "object",
"title": "take_screenshot_with_crosshairArguments",
"required": [
"nx",
"ny"
],
"properties": {
"nx": {
"type": "number",
"title": "Nx"
},
"ny": {
"type": "number",
"title": "Ny"
},
"zoom": {
"type": "number",
"title": "Zoom",
"default": 4
}
}
}
}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.
No parameters.
{
"name": "get_raw_screenshot",
"description": "\n Capture the RAW camera frame — no perspective warp, no crop to the calibrated\n screen quad. Use this to see exactly what the camera sees before any correction,\n e.g. when troubleshooting why take_screenshot looks wrong, or before adjusting\n corners with get_corners/set_corners.\n ",
"inputSchema": {
"type": "object",
"title": "get_raw_screenshotArguments",
"properties": {}
}
}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.
No parameters.
{
"name": "get_corners",
"description": "\n Get the phone's current screen-corner calibration.\n Returns {\"tl\": [nx,ny], \"tr\": [nx,ny], \"br\": [nx,ny], \"bl\": [nx,ny]} — each corner\n is a normalized point (0.0–1.0) in the RAW camera frame, defining the perspective\n warp that maps the camera view onto a flat rectangle representing the monitor.\n These four points are an arbitrary quadrilateral (trapezoid), not a bounding box —\n adjust one corner at a time without assuming the others move symmetrically.\n ",
"inputSchema": {
"type": "object",
"title": "get_cornersArguments",
"properties": {}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| bl * | array | |
| br * | array | |
| tl * | array | |
| tr * | array |
{
"name": "set_corners",
"description": "\n Update the phone's screen-corner calibration.\n Each corner is [nx, ny] normalized 0.0–1.0 in the raw camera frame.\n tl/tr/br/bl = top-left/top-right/bottom-right/bottom-left of the monitor as seen\n by the camera (an arbitrary trapezoid due to perspective — not a rectangle).\n Call get_corners() first to read the current values before nudging one of them.\n ",
"inputSchema": {
"type": "object",
"title": "set_cornersArguments",
"required": [
"tl",
"tr",
"br",
"bl"
],
"properties": {
"bl": {
"type": "array",
"items": {
"type": "number"
},
"title": "Bl"
},
"br": {
"type": "array",
"items": {
"type": "number"
},
"title": "Br"
},
"tl": {
"type": "array",
"items": {
"type": "number"
},
"title": "Tl"
},
"tr": {
"type": "array",
"items": {
"type": "number"
},
"title": "Tr"
}
}
},
"outputSchema": {
"type": "object",
"title": "set_cornersOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}Move mouse cursor to normalized coordinates WITHOUT clicking. nx, ny: float 0.0000–1.0000.
| Parameter | Type | Description |
|---|---|---|
| nx * | number | |
| ny * | number |
{
"name": "move_mouse",
"description": "\n Move mouse cursor to normalized coordinates WITHOUT clicking.\n nx, ny: float 0.0000–1.0000.\n ",
"inputSchema": {
"type": "object",
"title": "move_mouseArguments",
"required": [
"nx",
"ny"
],
"properties": {
"nx": {
"type": "number",
"title": "Nx"
},
"ny": {
"type": "number",
"title": "Ny"
}
}
},
"outputSchema": {
"type": "object",
"title": "move_mouseOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}Click at normalized screen coordinates. nx, ny: float 0.0000–1.0000 where (0,0) = top-left, (1,1) = bottom-right.
| Parameter | Type | Description |
|---|---|---|
| nx * | number | |
| ny * | number |
{
"name": "click",
"description": "\n Click at normalized screen coordinates.\n nx, ny: float 0.0000–1.0000 where (0,0) = top-left, (1,1) = bottom-right.\n ",
"inputSchema": {
"type": "object",
"title": "clickArguments",
"required": [
"nx",
"ny"
],
"properties": {
"nx": {
"type": "number",
"title": "Nx"
},
"ny": {
"type": "number",
"title": "Ny"
}
}
},
"outputSchema": {
"type": "object",
"title": "clickOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}Double-click at normalized screen coordinates.
| Parameter | Type | Description |
|---|---|---|
| nx * | number | |
| ny * | number |
{
"name": "double_click",
"description": "Double-click at normalized screen coordinates.",
"inputSchema": {
"type": "object",
"title": "double_clickArguments",
"required": [
"nx",
"ny"
],
"properties": {
"nx": {
"type": "number",
"title": "Nx"
},
"ny": {
"type": "number",
"title": "Ny"
}
}
},
"outputSchema": {
"type": "object",
"title": "double_clickOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}Type text on the computer keyboard.
| Parameter | Type | Description |
|---|---|---|
| text * | string |
{
"name": "type_text",
"description": "Type text on the computer keyboard.",
"inputSchema": {
"type": "object",
"title": "type_textArguments",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"title": "Text"
}
}
},
"outputSchema": {
"type": "object",
"title": "type_textOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}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])
| Parameter | Type | Description |
|---|---|---|
| keycodes * | array | |
| modifiers * | integer |
{
"name": "key",
"description": "\n Press a key combination.\n modifiers bitmask: LCtrl=1, LShift=2, LAlt=4, LWin=8\n Common keycodes: Enter=40, Escape=41, Tab=43, Space=44,\n F4=61, PageDown=78, PageUp=75, Win=227\n Examples:\n Alt+F4 → key(4, [61])\n Ctrl+W → key(1, [26])\n ",
"inputSchema": {
"type": "object",
"title": "keyArguments",
"required": [
"modifiers",
"keycodes"
],
"properties": {
"keycodes": {
"type": "array",
"items": {
"type": "integer"
},
"title": "Keycodes"
},
"modifiers": {
"type": "integer",
"title": "Modifiers"
}
}
},
"outputSchema": {
"type": "object",
"title": "keyOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}Scroll the mouse wheel. delta: number of ticks. Positive = scroll down, negative = scroll up.
| Parameter | Type | Description |
|---|---|---|
| delta * | integer |
{
"name": "scroll",
"description": "\n Scroll the mouse wheel.\n delta: number of ticks. Positive = scroll down, negative = scroll up.\n ",
"inputSchema": {
"type": "object",
"title": "scrollArguments",
"required": [
"delta"
],
"properties": {
"delta": {
"type": "integer",
"title": "Delta"
}
}
},
"outputSchema": {
"type": "object",
"title": "scrollOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
}
}Dittu controls a real computer through a phone camera + Bluetooth mouse/keyboard. The camera view can be imperfectly aligned, and clicks land at normalized (nx, ny) coordinates that may drift slightly from what you'd expect. Follow this workflow: 1. Call take_screenshot (or take_screenshot_with_grid for fine targets) BEFORE acting, to see the current state — never act blind on stale information. 2. Before clicking a small or important target, call move_mouse(nx, ny) first, then take_screenshot to confirm the cursor landed where you intended. Only call click() once you've visually confirmed the position. 3. After any action (click, type_text, key, scroll), take a fresh screenshot before deciding the next step — the screen state may have changed in ways you didn't expect. 4. If a click seems to have missed, don't repeat blindly — re-screenshot, re-locate the target, and re-move the mouse before retrying. Fixing screen-corner calibration (use if clicks are consistently off in one area, or if the visible screen looks cropped/has black margins): 1. get_corners() — read the current tl/tr/br/bl quadrilateral. These four points are an arbitrary trapezoid (perspective), NOT a rectangle — never assume symmetry. 2. Pick the edge that looks wrong. Call move_mouse(nx, ny) near that edge (e.g. nx=0.02 for the left edge, nx=0.98 for the right edge, keeping ny mid-screen-ish). 3. Call take_screenshot_with_crosshair(nx, ny) — it crops tightly around that point, zooms in, and draws a red crosshair at exactly where the cursor SHOULD be. 4. Compare: if the real cursor is missing from frame entirely, that edge is cropped — move the two corners on that edge further outward (away from screen center) in raw-camera-space. If the cursor appears offset from the crosshair, the corners need a small nudge in the direction of the offset, scaled by how far you are from that corner along each edge. 5. Call set_corners(...) with the adjusted quadrilateral, then repeat steps 2-4 to verify. 2-3 iterations is usually enough; don't over-correct on a single step.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.