Jinero

Official15 toolsLive

by jinero-online · JavaScript

AI-agent design tools: fonts, font recognition, palettes, color naming, contrast, code, SVG, CSS.

online.jinero/jinero — MCP Server

online.jinero/jinero is a hosted, remote Model Context Protocol (MCP) server. It provides AI agents with design tools from jinero.online, exposing a set of read-only capabilities for working with fonts and colors. The server targets agents such as Claude, Cursor, Cline, Zed, and Gemini CLI.

🛠️ Key Features

Hosted, remote MCP server for model-context access
Tooling for fonts (search, CSS, files, recognition from an image)
Color math (WCAG contrast, shades)
Color naming and palette extraction
Curated palettes and code minification

🚀 Use Cases

Generate or retrieve font information and CSS
Extract colors from existing assets and select matching palettes
Check and compute color contrast for accessibility
Convert design-related outputs into minified code where needed

⚡ Developer Benefits

Standard MCP integration via model-context protocol
Read-only tool set covering fonts, colors, palettes, and related code

⚠️ Limitations

Hosted remote access (not a local/self-hosted server)

Topics

ai-agentsapicolorsdesign-toolsfontsmcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

search_fonts

Search the free font catalog by name, category, style tags, language coverage, variable/monospace flags and style count. Returns a paginated list of families.

Parameters12

name	string	optional	Fuzzy name match.
category	string	optional	Comma-separated categories, e.g. 'serif,sans'.
langs	string	optional	Comma-separated language codes, e.g. 'latin,cyrillic' — ALL must be supported.
style	string	optional	Comma-separated style tags, e.g. 'handwriting,condensed' — ALL must match. One of: handwriting, script, display, slab, rounded, condensed, expanded, stencil, pixel, blackletter, outline, retro.
variable	boolean	optional	Only variable fonts.
monospace	boolean	optional	Only monospace fonts.
styles_min	integer	optional	Minimum number of styles.
styles_max	integer	optional	Maximum number of styles.
order	string	optional	Sort field, default 'likes'.
sort	string	optional	Sort direction.
per_page	integer	optional	Results per page (default 24).
page	integer	optional	Page number.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Fuzzy name match.",
      "type": "string"
    },
    "category": {
      "description": "Comma-separated categories, e.g. 'serif,sans'.",
      "type": "string"
    },
    "langs": {
      "description": "Comma-separated language codes, e.g. 'latin,cyrillic' — ALL must be supported.",
      "type": "string"
    },
    "style": {
      "description": "Comma-separated style tags, e.g. 'handwriting,condensed' — ALL must match. One of: handwriting, script, display, slab, rounded, condensed, expanded, stencil, pixel, blackletter, outline, retro.",
      "type": "string"
    },
    "variable": {
      "description": "Only variable fonts.",
      "type": "boolean"
    },
    "monospace": {
      "description": "Only monospace fonts.",
      "type": "boolean"
    },
    "styles_min": {
      "description": "Minimum number of styles.",
      "type": "integer"
    },
    "styles_max": {
      "description": "Maximum number of styles.",
      "type": "integer"
    },
    "order": {
      "description": "Sort field, default 'likes'.",
      "enum": [
        "likes",
        "downloads",
        "views",
        "name",
        "created_at"
      ],
      "type": "string"
    },
    "sort": {
      "description": "Sort direction.",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "per_page": {
      "description": "Results per page (default 24).",
      "minimum": 1,
      "maximum": 100,
      "type": "integer"
    },
    "page": {
      "description": "Page number.",
      "minimum": 1,
      "type": "integer"
    }
  }
}

recognize_font

Identify which font is used in an image. Powered by our OWN CNN embedding model, trained on the jinero font catalog — it matches fonts by visual shape/style, so it needs NO OCR and NO text (works for Latin and Cyrillic). Send a tight crop of one line of text as either image_url (public URL) or image_base64 (base64/data-URI, e.g. a local screenshot). The image is processed in memory and deleted immediately — never stored. Returns the most visually similar font families with scores. Typically 0.3-1.7 s (an OCR-assisted rerank of top candidates engages when retrieval is uncertain). Rate limit: 5 calls/min per IP (model inference is compute-heavy).

Parameters3

image_url	string	optional	Public URL of an image — a tight crop of one line of text. Provide either this or image_base64. Recognition is by visual shape (no OCR/text needed); Latin & Cyrillic supported.
image_base64	string	optional	Base64-encoded image (raw base64 or a data:image/...;base64 URI), max 8 MB decoded — use this to send a local file/screenshot without hosting it. Provide either this or image_url.
top_k	integer	optional	Number of font matches to return (3–20, default 8).

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "description": "Public URL of an image — a tight crop of one line of text. Provide either this or image_base64. Recognition is by visual shape (no OCR/text needed); Latin & Cyrillic supported.",
      "type": "string"
    },
    "image_base64": {
      "description": "Base64-encoded image (raw base64 or a data:image/...;base64 URI), max 8 MB decoded — use this to send a local file/screenshot without hosting it. Provide either this or image_url.",
      "type": "string"
    },
    "top_k": {
      "description": "Number of font matches to return (3–20, default 8).",
      "minimum": 3,
      "maximum": 20,
      "type": "integer"
    }
  }
}

get_font

Get full metadata for one font family by slug: styles, weights, axes, license, subsets and download/CSS URLs.

Parameters1

slug

string

required

Family slug, e.g. 'inter', 'playfair-display'.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Family slug, e.g. 'inter', 'playfair-display'.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

get_font_files

List every font file (weight/italic/format + direct woff2/ttf URL) for a family — handy for building custom @font-face rules.

Parameters1

slug

string

required

Family slug, e.g. 'inter'.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Family slug, e.g. 'inter'.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

get_fonts_css

Generate ready-to-use @font-face CSS for a family spec (Google-Fonts-compatible), e.g. "inter:wght@400,700" or a variable range "inter:wght@300..900". Returns CSS text.

Parameters2

family	string	required	Family spec, e.g. "inter:wght@400,700" or "inter:wght@300..900".
display	string	optional	font-display value (default swap).

Raw schema

{
  "type": "object",
  "properties": {
    "family": {
      "description": "Family spec, e.g. \"inter:wght@400,700\" or \"inter:wght@300..900\".",
      "type": "string"
    },
    "display": {
      "description": "font-display value (default swap).",
      "enum": [
        "swap",
        "auto",
        "block",
        "fallback",
        "optional"
      ],
      "type": "string"
    }
  },
  "required": [
    "family"
  ]
}

get_font_download_url

Return the direct ZIP download URL for a font family (all styles + a ready fonts.css). Does NOT download — hand the URL to the user or fetch it separately.

Parameters1

slug

string

required

Family slug, e.g. 'inter'.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Family slug, e.g. 'inter'.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

check_contrast

Check the WCAG contrast ratio between a foreground and background color, with AA/AAA pass/fail for normal and large text.

Parameters2

fg	string	required	Foreground color (hex, rgb(), or hsl()).
bg	string	required	Background color (hex, rgb(), or hsl()).

Raw schema

{
  "type": "object",
  "properties": {
    "fg": {
      "description": "Foreground color (hex, rgb(), or hsl()).",
      "type": "string"
    },
    "bg": {
      "description": "Background color (hex, rgb(), or hsl()).",
      "type": "string"
    }
  },
  "required": [
    "fg",
    "bg"
  ]
}

get_color_shades

Generate tints and shades for a base color (lighter/darker steps) with hex values.

Parameters3

hex	string	required	Base color in hex, rgb(), or hsl().
step	string	optional	Step percentage (default 10).
limit	integer	optional	Cap on tints/shades (default fills to ~100%).

Raw schema

{
  "type": "object",
  "properties": {
    "hex": {
      "description": "Base color in hex, rgb(), or hsl().",
      "type": "string"
    },
    "step": {
      "description": "Step percentage (default 10).",
      "enum": [
        "5",
        "10",
        "20",
        "25"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Cap on tints/shades (default fills to ~100%).",
      "minimum": 1,
      "maximum": 20,
      "type": "integer"
    }
  },
  "required": [
    "hex"
  ]
}

name_color

Get the closest human-readable name for one or more colors. Pass a single hex or several comma-separated (e.g. "#3b82f6,#000,#ff7f50"); returns each input with its nearest color name, the reference hex, an exact-match flag and the perceptual distance.

Parameters1

hex

string

required

A hex color, or several comma-separated (e.g. "#3b82f6,#000,#ff7f50"). Up to 100 at once.

Raw schema

{
  "type": "object",
  "properties": {
    "hex": {
      "description": "A hex color, or several comma-separated (e.g. \"#3b82f6,#000,#ff7f50\"). Up to 100 at once.",
      "type": "string"
    }
  },
  "required": [
    "hex"
  ]
}

extract_colors

Extract a dominant-color palette from an image. Send either a public image_url or image_base64 (base64/data-URI, e.g. a local screenshot). The image is processed in memory and never stored. Each color comes back with its hex, rgb, hsl, share of the image, and the closest human color name — a named palette in one call. Rate limit: 10 calls/min per IP.

Parameters4

image_url	string	optional	Public URL of the image to pull the palette from. Provide either this or image_base64.
image_base64	string	optional	Base64-encoded image (raw base64 or a data:image/...;base64 URI), max 10 MB decoded — use this to send a local file/screenshot without hosting it. Provide either this or image_url.
count	integer	optional	How many colors to return (2–16, default 8).
mode	string	optional	Palette mode: "balanced" (default), "vibrant", or "muted".

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "description": "Public URL of the image to pull the palette from. Provide either this or image_base64.",
      "type": "string"
    },
    "image_base64": {
      "description": "Base64-encoded image (raw base64 or a data:image/...;base64 URI), max 10 MB decoded — use this to send a local file/screenshot without hosting it. Provide either this or image_url.",
      "type": "string"
    },
    "count": {
      "description": "How many colors to return (2–16, default 8).",
      "type": "integer"
    },
    "mode": {
      "description": "Palette mode: \"balanced\" (default), \"vibrant\", or \"muted\".",
      "type": "string"
    }
  }
}

search_palettes

Search the color-palette catalog by name, tone, temperature, mood, harmony, exact color count and tags. Returns a paginated list.

Parameters10

name	string	optional	Fuzzy name match.
tone	string	optional	Overall tone.
temperature	string	optional	Color temperature.
mood	string	optional	e.g. pastel, muted, earthy, vibrant, monochrome.
harmony	string	optional	e.g. analogous, complementary, triadic, monochromatic, split-complementary, tetradic.
color_count	integer	optional	Exact number of colors.
tags	array	optional	Tag slugs — ALL must match (AND).
order	string	optional	Sort order (default newest).
per_page	integer	optional	Results per page (default 24).
page	integer	optional	Page number.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Fuzzy name match.",
      "type": "string"
    },
    "tone": {
      "description": "Overall tone.",
      "enum": [
        "light",
        "dark",
        "mixed"
      ],
      "type": "string"
    },
    "temperature": {
      "description": "Color temperature.",
      "enum": [
        "warm",
        "cool",
        "neutral"
      ],
      "type": "string"
    },
    "mood": {
      "description": "e.g. pastel, muted, earthy, vibrant, monochrome.",
      "type": "string"
    },
    "harmony": {
      "description": "e.g. analogous, complementary, triadic, monochromatic, split-complementary, tetradic.",
      "type": "string"
    },
    "color_count": {
      "description": "Exact number of colors.",
      "minimum": 2,
      "maximum": 10,
      "type": "integer"
    },
    "tags": {
      "description": "Tag slugs — ALL must match (AND).",
      "type": "array"
    },
    "order": {
      "description": "Sort order (default newest).",
      "enum": [
        "newest",
        "popular",
        "name"
      ],
      "type": "string"
    },
    "per_page": {
      "description": "Results per page (default 24).",
      "minimum": 1,
      "maximum": 100,
      "type": "integer"
    },
    "page": {
      "description": "Page number.",
      "minimum": 1,
      "type": "integer"
    }
  }
}

get_palette

Get one color palette by id: its colors (hex), name/derived title, mood, harmony, temperature and tags.

Parameters1

integer

required

Palette id.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Palette id.",
      "type": "integer"
    }
  },
  "required": [
    "id"
  ]
}

minify_code

Minify or beautify JS, CSS, HTML, SVG, JSON or XML text. Set type=auto to sniff the language. The code is only parsed and re-printed — never executed and never stored. Rate limit: 30 calls/min per IP.

Parameters4

code	string	required	Source code to transform.
type	string	required	Source language, or 'auto' to sniff.
mode	string	optional	Default minify.
keep_license	boolean	optional	Preserve /! ... / license comments when minifying.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "description": "Source code to transform.",
      "type": "string"
    },
    "type": {
      "description": "Source language, or 'auto' to sniff.",
      "enum": [
        "js",
        "css",
        "html",
        "svg",
        "json",
        "xml",
        "auto"
      ],
      "type": "string"
    },
    "mode": {
      "description": "Default minify.",
      "enum": [
        "minify",
        "beautify"
      ],
      "type": "string"
    },
    "keep_license": {
      "description": "Preserve /*! ... */ license comments when minifying.",
      "type": "boolean"
    }
  },
  "required": [
    "code",
    "type"
  ]
}

detect_code

Detect the language/format of a code snippet. Static analysis only — the snippet is never executed and never stored.

Parameters1

code

string

required

Snippet to inspect. Max 200,000 chars.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "description": "Snippet to inspect. Max 200,000 chars.",
      "type": "string"
    }
  },
  "required": [
    "code"
  ]
}

convert_code

Convert code between text formats (e.g. JSON↔YAML, CSS↔SCSS). Pure text transformation: the source is parsed and re-serialized, never executed and never stored. Use list_code_converters for valid from/to ids and per-converter options. Rate limit: 30 calls/min per IP.

Parameters4

code	string	required	Source code to convert.
from	string	required	Source format id (see list_code_converters).
to	string	required	Target format id.
options	object	optional	Per-converter options (see optionsSchema in list_code_converters).

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "description": "Source code to convert.",
      "type": "string"
    },
    "from": {
      "description": "Source format id (see list_code_converters).",
      "type": "string"
    },
    "to": {
      "description": "Target format id.",
      "type": "string"
    },
    "options": {
      "description": "Per-converter options (see optionsSchema in list_code_converters).",
      "type": "object"
    }
  },
  "required": [
    "code",
    "from",
    "to"
  ]
}

README.md15 KBView on GitHub

Jinero MCP Server

online.jinero/jinero — a hosted, remote Model Context Protocol server that gives AI agents (Claude, Cursor, Cline, Zed, Gemini CLI…) the design tools of jinero.online: 22 read-only tools for fonts (search, CSS, files, recognition from an image), color math (WCAG contrast, shades, naming, palette extraction), curated palettes, code minify/convert/detect, SVG optimization and SCSS helpers.

Endpoint: https://jinero.online/mcp (Streamable HTTP)
Auth: none — anonymous & free, rate-limited at 60 req/min per IP (plus per-tool caps on heavy tools, see below)
Registry: online.jinero/jinero in the official MCP registry
Manifest: /.well-known/mcp/server.json
Human docs: jinero.online/dev/mcp — full reference with example responses

Connect

Claude Code (CLI):

bash

claude mcp add --transport http jinero https://jinero.online/mcp

Claude Desktop / Cursor / Cline (config):

json

{
  "mcpServers": {
    "jinero": { "type": "http", "url": "https://jinero.online/mcp" }
  }
}

Older stdio-only clients can bridge with npx mcp-remote https://jinero.online/mcp.

Trust & safety

Every tool declares MCP annotations, verifiable in tools/list:

all 22 tools are readOnlyHint: true and idempotentHint: true;
submitted code/SVG is parsed and transformed as text — never executed, never stored;
uploaded images (font recognition, color extraction) are processed in memory and deleted immediately;
only three tools fetch a user-supplied URL (recognize_font, extract_colors, svg_to_datauri) — marked openWorldHint: true, with SSRF-guarded, size-capped fetches.

A note for automated risk scanners: some directories classify minify_code, convert_code, generate_clamp or recognize_font as "write" tools based on their verbs. They are pure functions — text/math in, text out; nothing on the server or the caller's side is modified. The authoritative signal is the readOnlyHint: true annotation each of the 22 tools declares in tools/list (snapshotted in tools.json).

Rate limits

The whole endpoint is capped at 60 requests/min per IP. On top of that, compute-heavy tools enforce their own per-tool per-IP caps (server v1.4.0+), returned as a clean tool error with a retry hint when exceeded — each cap is also stated in the tool's description:

Tool	Cap	Why
`recognize_font`	5/min	CNN model inference
`extract_colors`	10/min	image analysis subprocess
`minify_code`, `convert_code`, `optimize_svg`	30/min	parser subprocesses
`svg_to_datauri`	30/min	may fetch external URLs

Tests & CI

tests/tools.test.mjs exercises every declared tool against the live endpoint (zero dependencies, Node 20+):

bash

npm test

CI runs the suite on every push and weekly (workflow), and tools.json is a committed snapshot of the live tools/list — schemas and annotations included (npm run update-snapshot to refresh).

Try it without a client

bash

# List all tools
curl -s -X POST https://jinero.online/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

More runnable examples in examples/.

Tool reference

Generated from the live tools/list of the current server version.

Fonts

`search_fonts`

Search the free font catalog by name, category, style tags, language coverage, variable/monospace flags and style count. Returns a paginated list of families.

read-only · idempotent

Parameter	Type	Description
`name`	string	Fuzzy name match.
`category`	string	Comma-separated categories, e.g. 'serif,sans'.
`langs`	string	Comma-separated language codes, e.g. 'latin,cyrillic' — ALL must be supported.
`style`	string	Comma-separated style tags, e.g. 'handwriting,condensed' — ALL must match. One of: handwriting, script, display, slab, rounded, condensed, expanded, stencil, pixel, blackletter, outline, retro.
`variable`	boolean	Only variable fonts.
`monospace`	boolean	Only monospace fonts.
`styles_min`	integer	Minimum number of styles.
`styles_max`	integer	Maximum number of styles.
`order`	string: likes \| downloads \| views \| name \| created_at	Sort field, default 'likes'.
`sort`	string: asc \| desc	Sort direction.
`per_page`	integer	Results per page (default 24).
`page`	integer	Page number.

`recognize_font`

read-only · idempotent · fetches external URLs

Parameter	Type	Description
`image_url`	string	Public URL of an image — a tight crop of one line of text. Provide either this or image_base64. Recognition is by visual shape (no OCR/text needed); Latin & Cyrillic supported.
`image_base64`	string	Base64-encoded image (raw base64 or a data:image/...;base64 URI), max 8 MB decoded — use this to send a local file/screenshot without hosting it. Provide either this or image_url.
`top_k`	integer	Number of font matches to return (3–20, default 8).

`get_font`

Get full metadata for one font family by slug: styles, weights, axes, license, subsets and download/CSS URLs.

read-only · idempotent

Parameter	Type	Description
`slug` (required)	string	Family slug, e.g. 'inter', 'playfair-display'.

`get_font_files`

List every font file (weight/italic/format + direct woff2/ttf URL) for a family — handy for building custom @font-face rules.

read-only · idempotent

Parameter	Type	Description
`slug` (required)	string	Family slug, e.g. 'inter'.

`get_fonts_css`

Generate ready-to-use @font-face CSS for a family spec (Google-Fonts-compatible), e.g. "inter:wght@400,700" or a variable range "inter:wght@300..900". Returns CSS text.

read-only · idempotent

Parameter	Type	Description
`family` (required)	string	Family spec, e.g. "inter:wght@400,700" or "inter:wght@300..900".
`display`	string: swap \| auto \| block \| fallback \| optional	font-display value (default swap).

`get_font_download_url`

Return the direct ZIP download URL for a font family (all styles + a ready fonts.css). Does NOT download — hand the URL to the user or fetch it separately.

read-only · idempotent

Parameter	Type	Description
`slug` (required)	string	Family slug, e.g. 'inter'.

Colors

`check_contrast`

Check the WCAG contrast ratio between a foreground and background color, with AA/AAA pass/fail for normal and large text.

read-only · idempotent

Parameter	Type	Description
`fg` (required)	string	Foreground color (hex, rgb(), or hsl()).
`bg` (required)	string	Background color (hex, rgb(), or hsl()).

`get_color_shades`

Generate tints and shades for a base color (lighter/darker steps) with hex values.

read-only · idempotent

Parameter	Type	Description
`hex` (required)	string	Base color in hex, rgb(), or hsl().
`step`	string: 5 \| 10 \| 20 \| 25	Step percentage (default 10).
`limit`	integer	Cap on tints/shades (default fills to ~100%).

`name_color`

read-only · idempotent

Parameter	Type	Description
`hex` (required)	string	A hex color, or several comma-separated (e.g. "#3b82f6,#000,#ff7f50"). Up to 100 at once.

`extract_colors`

read-only · idempotent · fetches external URLs

Parameter	Type	Description
`image_url`	string	Public URL of the image to pull the palette from. Provide either this or image_base64.
`image_base64`	string	Base64-encoded image (raw base64 or a data:image/...;base64 URI), max 10 MB decoded — use this to send a local file/screenshot without hosting it. Provide either this or image_url.
`count`	integer	How many colors to return (2–16, default 8).
`mode`	string	Palette mode: "balanced" (default), "vibrant", or "muted".

Palettes

`search_palettes`

Search the color-palette catalog by name, tone, temperature, mood, harmony, exact color count and tags. Returns a paginated list.

read-only · idempotent

Parameter	Type	Description
`name`	string	Fuzzy name match.
`tone`	string: light \| dark \| mixed	Overall tone.
`temperature`	string: warm \| cool \| neutral	Color temperature.
`mood`	string	e.g. pastel, muted, earthy, vibrant, monochrome.
`harmony`	string	e.g. analogous, complementary, triadic, monochromatic, split-complementary, tetradic.
`color_count`	integer	Exact number of colors.
`tags`	array	Tag slugs — ALL must match (AND).
`order`	string: newest \| popular \| name	Sort order (default newest).
`per_page`	integer	Results per page (default 24).
`page`	integer	Page number.

`get_palette`

Get one color palette by id: its colors (hex), name/derived title, mood, harmony, temperature and tags.

read-only · idempotent

Parameter	Type	Description
`id` (required)	integer	Palette id.

Code

`minify_code`

Minify or beautify JS, CSS, HTML, SVG, JSON or XML text. Set type=auto to sniff the language. The code is only parsed and re-printed — never executed and never stored.

read-only · idempotent

Parameter	Type	Description
`code` (required)	string	Source code to transform.
`type` (required)	string: js \| css \| html \| svg \| json \| xml \| auto	Source language, or 'auto' to sniff.
`mode`	string: minify \| beautify	Default minify.
`keep_license`	boolean	Preserve /! ... / license comments when minifying.

`detect_code`

Detect the language/format of a code snippet. Static analysis only — the snippet is never executed and never stored.

read-only · idempotent

Parameter	Type	Description
`code` (required)	string	Snippet to inspect. Max 200,000 chars.

`convert_code`

read-only · idempotent

Parameter	Type	Description
`code` (required)	string	Source code to convert.
`from` (required)	string	Source format id (see list_code_converters).
`to` (required)	string	Target format id.
`options`	object	Per-converter options (see optionsSchema in list_code_converters).

`list_code_converters`

List available code converters with their from/to ids and per-converter option schemas.

read-only · idempotent

No parameters.

SVG

`optimize_svg`

Optimize/clean SVG markup (SVGO). Pure markup transformation — nothing is executed or stored. Returns minified SVG plus before/after sizes.

read-only · idempotent

Parameter	Type	Description
`svg` (required)	string	SVG source. Max 500,000 chars.
`preset`	string: safe \| balanced \| aggressive	Optimization preset (default balanced).

`svg_to_datauri`

Encode an SVG (or fetched image) as a CSS-ready data: URI. Provide either raw svg or a url.

read-only · idempotent · fetches external URLs

Parameter	Type	Description
`svg`	string	Raw SVG markup. Mutually exclusive with url.
`url`	string	Public image URL the server will fetch.
`encoding`	string: utf8 \| base64	Defaults: utf8 for SVG, base64 for raster.
`quotes`	string: single \| double	Quote style for the data URI (default double).

`list_svg_presets`

List the available SVG optimization presets and what each one does.

read-only · idempotent

No parameters.

Dev

`list_scss_mixins`

List the SCSS mixin catalog (id, title, short description), optionally filtered by group or search.

read-only · idempotent

Parameter	Type	Description
`group`	string	e.g. Bootstrap, Project, Pattern, Placeholder.
`search`	string	Fuzzy substring across id/title/short/desc.
`fields`	string: summary \| full	Detail level (default summary).

`get_scss_mixin`

Get one SCSS mixin by id: full source, parameters and usage example.

read-only · idempotent

Parameter	Type	Description
`id` (required)	string	Mixin id (kebab-case), e.g. 'centerer', 'media-breakpoint-up'.

`generate_clamp`

Calculate a fluid CSS clamp() expression for responsive sizing between two viewport widths. Pure calculation — returns a CSS snippet, writes and stores nothing.

read-only · idempotent

Parameter	Type	Description
`min_fs` (required)	number	Minimum size in px.
`max_fs` (required)	number	Maximum size in px.
`min_vw`	number	Viewport width at min_fs (default 320).
`max_vw`	number	Viewport width at max_fs (default 1440).
`unit`	string: px \| rem \| both	Output unit (default rem).
`root`	number	Root font-size in px for rem conversion (default 16).

About

Built and operated by jinero.online — free design tools for fonts, icons, colors and code. The MCP server is a thin wrapper over the same public REST API: one contract, identical behavior.

This repository holds the public documentation and examples for the server. Issues and feature requests for the tools are welcome here.

Install

Tools (15)

search_fontsrecognize_fontget_fontget_font_filesget_fonts_cssget_font_download_urlcheck_contrastget_color_shades

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://jinero.online/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "jinero": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://jinero.online/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

online.jinero/jinero — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_fonts

recognize_font

get_font

get_font_files

get_fonts_css

get_font_download_url

check_contrast

get_color_shades

name_color

extract_colors

search_palettes

get_palette

minify_code

detect_code

convert_code

Jinero MCP Server

Connect

Trust & safety

Rate limits

Tests & CI

Try it without a client

Tool reference

Fonts

search_fonts

recognize_font

get_font

get_font_files

get_fonts_css

get_font_download_url

Colors

check_contrast

get_color_shades

name_color

extract_colors

Palettes

search_palettes

get_palette

Code

minify_code

detect_code

convert_code

list_code_converters

SVG

optimize_svg

svg_to_datauri

list_svg_presets

Dev

list_scss_mixins

get_scss_mixin

generate_clamp

About

Install

Remote endpoint

Related servers

`search_fonts`

`recognize_font`

`get_font`

`get_font_files`

`get_fonts_css`

`get_font_download_url`

`check_contrast`

`get_color_shades`

`name_color`

`extract_colors`

`search_palettes`

`get_palette`

`minify_code`

`detect_code`

`convert_code`

`list_code_converters`

`optimize_svg`

`svg_to_datauri`

`list_svg_presets`

`list_scss_mixins`

`get_scss_mixin`

`generate_clamp`