# Tools MCP

> Tools MCP is a free MCP server for developer tools. Local web-production utilities for agents: contrast, JSON-LD, WebP, slugs and dates. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Repository:** https://github.com/first-ch/firstch-tools-mcp
- **MCP Registry name:** io.github.First-CH/tools-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add tools-mcp -- npx -y @first-ch/tools-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tools-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@first-ch/tools-mcp"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/tools-mcp
