Tools MCP
Local web-production utilities for agents: contrast, JSON-LD, WebP, slugs and dates
- Pricing
- Free
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.59.0
- Listing updated
- today
Similar MCP servers
About Tools MCP
Tools MCP is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Most of the tools here are built for Japanese web work. They count characters the way X weighs them (full-width characters count double, URLs a flat 23), turn Japanese era dates into Western ones, calculate business days with Japanese public holidays, and make URL slugs from Japanese titles. The rest are general utilities: WCAG contrast, JSON-LD, llms.txt, WebP conversion, hashing, JWT decoding, cron explanations and CIDR maths.
The local tools run on your own machine. A second group of app_* tools covers 42 web apps at apps.first-ch.com (SEO and GEO readiness, meta tags, security headers, SSL, DNS, redirects, broken links). Those send the URL, domain or text you give them to that site and return its JSON, so they are the one part that is not local.
It needs Node.js 24 or later and starts through npx. Optional environment variables set a usage-log file, the app base URL and the Chrome path used for PDF output from Marp slides.
Install
Run in a terminal
claude mcp add tools-mcp -- npx -y @first-ch/tools-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tools-mcp": {
"command": "npx",
"args": [
"-y",
"@first-ch/tools-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tools-mcp": {
"command": "npx",
"args": [
"-y",
"@first-ch/tools-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tools-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@first-ch/tools-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tools-mcp": {
"command": "npx",
"args": [
"-y",
"@first-ch/tools-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tools-mcp": {
"command": "npx",
"args": [
"-y",
"@first-ch/tools-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
FIRSTCH_TOOLS_USAGE_LOGOptional. Path to a local JSONL file for opt-in usage logging. No logging when unset.FIRSTCH_APPS_BASE_URLOptional. Base URL for the app_* tools (default https://apps.first-ch.com). For testing only.MARP_CHROME_PATHOptional. Path to a Chrome/Chromium executable used by marp_render for PDF output. Auto-detected on common paths when unset; PDF is skipped (HTML still returned) if none is found.
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- contrast_check
- WCAG 2.1 contrast ratio with AA/AAA pass or fail
- count_chars
- Japanese character counts and X post weight
- webp_convert
- Convert PNG/JPEG files to WebP
- jsonld_generate
- Generate schema.org JSON-LD
- llmstxt_generate
- Generate an llms.txt file
- encoding_convert
- Detect and convert text encoding and line endings
- marp_render
- Render Marp Markdown to HTML or PDF slides
- testdata_generate
- Generate fictional test data records or boundary-length strings
- diff_check
- Compare two texts and return a unified diff
- cron_explain
- Explain a cron expression and list upcoming runs
- base64_encode
- Encode or decode Base64 and data URIs
What it does
- WCAG contrast checks
- Returns the contrast ratio for two colours with AA and AAA results for text and UI components.
- Japanese text counting
- Counts graphemes, full-width and half-width characters and the X post weight.
- Schema and llms.txt output
- Generates schema.org JSON-LD for organisation, FAQ, service and breadcrumb, plus llms.txt files.
- File conversion
- Converts PNG and JPEG to WebP, detects and converts text encodings, and renders Marp Markdown to HTML or PDF.
- Developer helpers
- Covers cron explanations, text diffs, Base64, hashing, JWT decoding and IP/CIDR calculation.
- Hosted site-check tools
- The `app_*` tools run site audits on apps.first-ch.com and need network access.
Good for
- Check colour pairs against WCAG before shipping a design
- Count characters for a Japanese post before publishing to X
- Generate JSON-LD and llms.txt for a small business site
- Convert a folder of PNGs to WebP from an agent session
- Explain a cron expression and list its next run times
Pricing
Free
Free tools; the app_* tools call apps.first-ch.com
Tools MCP FAQ
Does anything leave my machine?
The local tools run on your computer. Only the `app_*` tools send the URL, domain or text you pass to apps.first-ch.com.
Which Node.js version is required?
Node.js 24 or later, because the server runs through npx.
How do I add it to Claude Code?
Run `claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp`, or install the Claude Code plugin from the First-CH marketplace.
Can it write files in Shift_JIS?
No. The encoding tool outputs UTF-8 only, although it can detect Shift_JIS input.
Is Tools MCP free?
Yes. Tools MCP is free to use.
How do I add Tools MCP to Claude Code?
Run this command in your terminal: claude mcp add tools-mcp -- npx -y @first-ch/tools-mcp
What are the best alternatives to Tools MCP?
The closest alternatives to Tools MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


