For coding agents

The site's numbers are a dataset first: 22 devices and 135 readings, version 1.0.0 of 2026-11-17. Connect an agent to the MCP server, install the agent skill, fetch the files below, or fetch a Markdown copy of any page.

MCP server

https://screens.guide/mcp is a remote MCP server over Streamable HTTP, with no sign-in. Add it to Claude Code with claude mcp add --transport http screens-guide https://screens.guide/mcp, or give the URL to any MCP client. Its tools read the dataset and change nothing:

ToolWhat it does
list_devicesList the measured devices
get_deviceGet a device's readings
compare_devicesCompare devices
check_layoutCheck a layout against a device
convert_unitsConvert between pt, dp and px

Agent skill

The screens-guide skill tells an agent where to read the numbers, which layout rules the measurements support, with their numbers, and how to review a screen against a device. It carries a snapshot of each device's current readings, references/devices.md, for an agent without network access. Read it at /skills/screens-guide/SKILL.md, or download the folder as screens-guide.zip.

Install

The Claude Code plugin installs the skill and the MCP server together. Elsewhere they install apart: the skill from the repository or the zip, the server from its URL.

Claude Code

claude.ai

The Claude API

Upload the skill's files to POST https://api.anthropic.com/v1/skills, each as a files[] field named screens-guide/<path>, then name the returned skill_id in a Messages request's container.skills, beside the code execution tool. The steps are in Anthropic's skills guide.

Other agents

Codex, Cursor, GitHub Copilot and Gemini CLI read the same skill format. Each step below follows the agent's documentation as read on 2026-11-18.

Files

URLWhat
/data/v1/devices.jsonthe whole dataset: every device and every reading
/data/v1/devices/<id>.jsonone device, with the dataset's version and the runs its readings name; for example /data/v1/devices/iphone-17.json
/data/v1/devices.csvone row per device, screen, orientation and runtime; nested fields joined with _, lists and missing as JSON text
/data/v1/schema.jsonthe JSON Schema (draft 2020-12) of devices.json; a device file's device follows its $defs/device
/data/v1/version.jsonthe dataset version, its date, and the counts of devices, runtimes and readings
/llms.txtan index of the site for language models
/llms-full.txtevery device's current reading as Markdown tables, and the guide

Every page has a Markdown copy at its path plus .md: /devices/iphone-17.md for /devices/iphone-17, and /index.md for the home page. A request for the page itself with Accept: text/markdown gets the copy, and the HTML names it in a Link header. The files and the copies allow requests from any origin.

Reading the data

License and citation

The dataset is licensed under Creative Commons Attribution 4.0: copy, change and redistribute it, commercially too, with credit. Credit it as "screens.guide, measured by Modaal" with a link to https://screens.guide, and name the version you used, 1.0.0. The code and pages are MIT-licensed.