modelread MCP
A hardware-aware fit checker for Hugging Face models that determines if a model runs on specific hardware, identifies the best quantization, estimates tokens per second, and provides exact launch commands for inference engines like llama.cpp, vLLM, or MLX.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://modelread.com/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to modelread.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Check if a Hugging Face model fits on a specific device
- Find the best quantization for a model on given hardware
- Estimate inference speed (tokens/sec) for a model
- Generate exact launch commands for model serving
Source and maintenance
Protocol and capabilities
- Server
- modelread 0.3.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 6 advertised
- Resources
- 1 advertised
- Resource templates
- 0 advertised
- Prompts
- 3 advertised
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
estimate_fit — Estimate model fit and speed
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.
{
"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
}
}
}{
"title": "Estimate model fit and speed",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}compare_hardware — Compare one model across devices
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).
{
"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"
}
}
}{
"title": "Compare one model across devices",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}find_models — Find the best models for a device
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.
{
"type": "object",
"title": "find_modelsArguments",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"title": "Question"
}
}
}{
"title": "Find the best models for a device",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ask — Ask about running models
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.
{
"type": "object",
"title": "askArguments",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"title": "Question"
}
}
}{
"title": "Ask about running models",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search_models — Search the model index
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.
{
"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
}
}
}{
"type": "object",
"title": "search_modelsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
}{
"title": "Search the model index",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_hardware — List hardware presets
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.
{
"type": "object",
"title": "list_hardwareArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 40
},
"filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Filter",
"default": null
}
}
}{
"type": "object",
"title": "list_hardwareOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
}{
"title": "List hardware presets",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
3 advertised
will_it_run — Will it run?
Check whether a model fits a device and how to launch it.
- repo
- No description (required)
- hardware
- No description (required)
- ctx
- No description
best_for_my_machine — Best model for my machine
Rank models for a task on a device.
- task
- No description (required)
- hardware
- No description (required)
- ctx
- No description
size_a_server — Size a server
Pick hardware and settings to serve a model to many users.
- repo
- No description (required)
- users
- No description
- candidates
- No description
Resources
1 advertised
hardware_catalog — Hardware catalog
Every device preset (id, name, kind, segment, memory, bandwidth, backend) as JSON.
modelread://hardware90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-19: 3 of 3 checks answered
- 2026-11-20: 3 of 3 checks answered
- 2026-11-21: 4 of 4 checks answered
- 2026-11-22: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 792 ms
- 95th percentile latency
- 792 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 792 ms · metadata changed · 6 tool(s), 1 resource(s), 0 resource template(s), 3 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http modelread-mcp https://modelread.com/mcpCodex
codex mcp add modelread-mcp --url https://modelread.com/mcpCursor
{
"mcpServers": {
"modelread-mcp": {
"url": "https://modelread.com/mcp"
}
}
}Cline
{
"mcpServers": {
"modelread-mcp": {
"type": "streamableHttp",
"url": "https://modelread.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"modelread-mcp": {
"type": "http",
"url": "https://modelread.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http modelread-mcp https://modelread.com/mcpClaude Desktop
https://modelread.com/mcpWindsurf
{
"mcpServers": {
"modelread-mcp": {
"serverUrl": "https://modelread.com/mcp"
}
}
}Let your agent find its tools
Find servers like modelread MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other ai and machine learning servers
Do you run modelread MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.