Skip to content
MCP server

Tools MCP

Local web-production utilities for agents: contrast, JSON-LD, WebP, slugs and dates

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers