modelread is an MCP server published by io.github.patrickbdevaney, hosted at modelread.vercel.app. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 6 tools, including estimate_fit, compare_hardware, find_models, ask, search_models.
Will this Hugging Face model run on my hardware? Fit, best quant, tok/s range, launch command.
87 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Will this Hugging Face repo run on this hardware? Checks the repo and its quantized derivatives (GGUF/MLX/AWQ...) and returns, per candidate: verdict (fits | fits-tight | offload | no | unknown), memory placement (VRAM / RAM / SSD), longest context that fits, decode and prefill tok/s bands with basis, concurrent-serving aggregate, runtime support (llama.cpp / vLLM / MLX registries) and an exact launch command. repo: 'org/name' (base model or a GGUF repo). hardware: preset id, '<N>x-<id>', free text, or 'gpu=..,ram=..,bw=..'. ctx in tokens.
| Parameter | Type | Description |
|---|---|---|
| ctx | integer | |
| repo * | string | |
| ram_gb | any | |
None yet. Changes appear after a server's second daily check.
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.
| hardware * |
| string |
| include_vision | boolean |
| kv_cache_dtype | string |
| check_quantized_derivatives | boolean |
{
"name": "estimate_fit",
"title": "Estimate model fit and speed",
"description": "Will this Hugging Face repo run on this hardware? Checks the repo and its quantized derivatives (GGUF/MLX/AWQ...) and returns, per candidate: verdict (fits | fits-tight | offload | no | unknown), memory placement (VRAM / RAM / SSD), longest context that fits, decode and prefill tok/s bands with basis, concurrent-serving aggregate, runtime support (llama.cpp / vLLM / MLX registries) and an exact launch command. repo: 'org/name' (base model or a GGUF repo). hardware: preset id, '<N>x-<id>', free text, or 'gpu=..,ram=..,bw=..'. ctx in tokens.",
"inputSchema": {
"type": "object",
"title": "estimate_fitArguments",
"required": [
"repo",
"hardware"
],
"properties": {
"ctx": {
"type": "integer",
"title": "Ctx",
"default": 8192
},
"repo": {
"type": "string",
"title": "Repo"
},
"ram_gb": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Ram Gb",
"default": null
},
"hardware": {
"type": "string",
"title": "Hardware"
},
"include_vision": {
"type": "boolean",
"title": "Include Vision",
"default": false
},
"kv_cache_dtype": {
"type": "string",
"title": "Kv Cache Dtype",
"default": "f16"
},
"check_quantized_derivatives": {
"type": "boolean",
"title": "Check Quantized Derivatives",
"default": true
}
}
},
"annotations": {
"title": "Estimate model fit and speed",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Run one repo against several devices and return the best candidate per device (verdict, quant, decode band, max context, launch command), sorted best first. Use for 'which of my machines should run X' or 'is a 4090 or an M4 Max better for X'. hardware: comma-separated list of presets / free text (max 8).
| Parameter | Type | Description |
|---|---|---|
| ctx | integer | |
| repo * | string | |
| hardware * | string |
{
"name": "compare_hardware",
"title": "Compare one model across devices",
"description": "Run one repo against several devices and return the best candidate per device (verdict, quant, decode band, max context, launch command), sorted best first. Use for 'which of my machines should run X' or 'is a 4090 or an M4 Max better for X'. hardware: comma-separated list of presets / free text (max 8).",
"inputSchema": {
"type": "object",
"title": "compare_hardwareArguments",
"required": [
"repo",
"hardware"
],
"properties": {
"ctx": {
"type": "integer",
"title": "Ctx",
"default": 8192
},
"repo": {
"type": "string",
"title": "Repo"
},
"hardware": {
"type": "string",
"title": "Hardware"
}
}
},
"annotations": {
"title": "Compare one model across devices",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Recommend models for a task on given hardware, written as a natural question, e.g. 'best coding model for an RTX 4090 + 64GB RAM at 32k context', 'Japanese chat on a Galaxy S25 Ultra', 'serve 8 users on 2x RTX 3090'. Ranks indexed Hub models (~20k, refreshed nightly) by fit, task benchmark percentile (provenance-tagged, vendor vs independent), speed and adoption; each result carries a full fit estimate. Tasks understood: chat, coding, agentic, vision, ocr, math, reasoning, multilingual, function-calling, embedding, reranking, speech-to-text, tts, image-generation, video-generation.
| Parameter | Type | Description |
|---|---|---|
| question * | string |
{
"name": "find_models",
"title": "Find the best models for a device",
"description": "Recommend models for a task on given hardware, written as a natural question, e.g. 'best coding model for an RTX 4090 + 64GB RAM at 32k context', 'Japanese chat on a Galaxy S25 Ultra', 'serve 8 users on 2x RTX 3090'. Ranks indexed Hub models (~20k, refreshed nightly) by fit, task benchmark percentile (provenance-tagged, vendor vs independent), speed and adoption; each result carries a full fit estimate. Tasks understood: chat, coding, agentic, vision, ocr, math, reasoning, multilingual, function-calling, embedding, reranking, speech-to-text, tts, image-generation, video-generation.",
"inputSchema": {
"type": "object",
"title": "find_modelsArguments",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"title": "Question"
}
}
},
"annotations": {
"title": "Find the best models for a device",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Free-form question about running Hugging Face models locally or self-hosted (runtimes, quant choice, KV cache, why something OOMs, MoE offload); returns markdown plus the parsed query and notes.
| Parameter | Type | Description |
|---|---|---|
| question * | string |
{
"name": "ask",
"title": "Ask about running models",
"description": "Free-form question about running Hugging Face models locally or self-hosted (runtimes, quant choice, KV cache, why something OOMs, MoE offload); returns markdown plus the parsed query and notes.",
"inputSchema": {
"type": "object",
"title": "askArguments",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"title": "Question"
}
}
},
"annotations": {
"title": "Ask about running models",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Search the model index without estimating (fast): ids, task, library, params, downloads, likes, license, created date. task: chat|coding|vision|embedding|... ; query: substring of the repo id (e.g. 'qwen3', 'gemma-4'); max_params_billion filters by size.
| Parameter | Type | Description |
|---|---|---|
| task | string | |
| limit | integer | |
| query | any | |
| max_params_billion | any |
{
"name": "search_models",
"title": "Search the model index",
"description": "Search the model index without estimating (fast): ids, task, library, params, downloads, likes, license, created date. task: chat|coding|vision|embedding|... ; query: substring of the repo id (e.g. 'qwen3', 'gemma-4'); max_params_billion filters by size.",
"inputSchema": {
"type": "object",
"title": "search_modelsArguments",
"properties": {
"task": {
"type": "string",
"title": "Task",
"default": "chat"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"max_params_billion": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Params Billion",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"title": "search_modelsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Search the model index",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List hardware presets (330+: GPUs of every vendor and segment, multi-GPU nodes, Apple, Jetson/APUs, phones, tablets, SBCs, VPS tiers). filter: words matched against id/name/vendor/segment, e.g. 'h100', 'amd datacenter', 'phone samsung', 'vps'. Returns id, name, kind, memory, bandwidth, backend.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| filter | any |
{
"name": "list_hardware",
"title": "List hardware presets",
"description": "List hardware presets (330+: GPUs of every vendor and segment, multi-GPU nodes, Apple, Jetson/APUs, phones, tablets, SBCs, VPS tiers). filter: words matched against id/name/vendor/segment, e.g. 'h100', 'amd datacenter', 'phone samsung', 'vps'. Returns id, name, kind, memory, bandwidth, backend.",
"inputSchema": {
"type": "object",
"title": "list_hardwareArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 40
},
"filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Filter",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"title": "list_hardwareOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "List hardware presets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use modelread whenever the user asks whether a Hugging Face / open-weights model will run on a GPU, Mac, phone, multi-GPU node or cloud instance; how many tokens/sec to expect; which GGUF/MLX/AWQ/FP8 quant fits in VRAM; how much context fits; what to run on a given machine; or needs a llama.cpp / vLLM / MLX / Ollama launch command (also before downloading, quantizing or serving a model). modelread: will a Hugging Face model run on given hardware, how fast, which quant, with what command. Numbers come from real repo file sizes, GGUF/safetensors tensor headers and configs (nothing is downloaded), plus calibration measured on real devices. Pick the tool by the question: - a specific repo + one device -> estimate_fit - a specific repo + several devices ('which of my machines') -> compare_hardware - 'what should I run on X for task Y' -> find_models - anything else (runtimes, KV cache, why it OOMs) -> ask - just listing/searching models -> search_models; device ids -> list_hardware (use a filter). Hardware can be a preset id (rtx4090, m4max-128, 8x-h100-sxm, iphone-17pro-12, rpi5-8, vps-4vcpu-8gb), any '<N>x-<gpu id>' multi-GPU spec, free text ('two RTX 3090s', 'MacBook Pro M3 Max 128GB', 'Galaxy S25 Ultra'), or 'gpu=24,ram=64,bw=936' / 'unified=1,ram=96,bw=256'. Speeds are bands (lo/mid/hi) with their basis; decode_tps.aggregate gives concurrent-serving throughput at 1-32 parallel sequences. Respect 'verdict', 'unknowns' and 'confidence': never present an 'unknown' verdict as a fit, and quote the band, not just mid.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.