A Model Context Protocol server that exposes mate.tools utilities as callable tools inside Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible agent.
27 MCP tools across 6 categories. Each calls the public mate.tools JSON API over HTTPS — no local data, no API keys, no signup. The list grows over time; npx -y always pulls the latest version.
| MCP tool name | What it does |
|---|---|
count_lines | Count lines, words, sentences, paragraphs and characters. Returns 16 metrics including duplicate-line detection and line-ending detection (LF/CRLF/CR). |
case_convert | Convert text into 9 case styles in one call: upper, lower, title, sentence, snake, kebab, camel, pascal, constant. |
slugify | Convert any text to a URL-safe slug. Unicode-aware, configurable separator and length, optional transliteration of non-Latin characters. |
sort_lines | Sort lines of text. Asc/desc, case-sensitivity, dedupe, natural-sort (line2 before line10), locale-aware collation. |
lorem_ipsum | Generate placeholder text — paragraphs, sentences or words. |
regex_test | Match / replace / split text with a PCRE regex. Returns capture-group offsets. ReDoS-protected (hard backtrack limit). |
text_diff | Diff two strings by line, word or character. Returns structured changes, unified diff string, and Jaccard similarity score. |
| MCP tool name | What it does |
|---|---|
base64_encode | Base64-encode text. Standard or URL-safe alphabet (RFC 4648 §5). |
base64_decode | Base64-decode. Accepts standard + URL-safe, auto-fixes missing padding, returns hex when output isn't valid UTF-8. |
url_encode | Percent-encode a string. Component / form / path mode. |
url_decode | Decode percent-encoded URL strings. |
| MCP tool name | What it does |
|---|---|
hash | MD5, SHA-1, SHA-256, SHA-384, SHA-512, SHA3-256, SHA3-512, CRC32 (or any subset of PHP's hash algorithms). |
password | Generate cryptographically random passwords (CSPRNG). Configurable length, count, classes, ambiguous-char exclusion. Reports entropy. |
password_strength | Score a password 0–4 (zxcvbn-style), entropy bits, offline-GPU crack-time estimate, concerns and suggestions. |
credit_card_validate | Luhn check + brand detection (Visa / MC / Amex / Discover / JCB / Diners / UnionPay / Maestro / RuPay). PAN never logged. |
| MCP tool name | What it does |
|---|---|
json_format | Validate, pretty-print, minify or analyse JSON. Returns structural summary (node counts, max depth, top keys). |
json_to_csv | Convert a JSON array of objects to CSV. Configurable delimiter, columns, optional flattening of nested objects (dot keys). |
xml_validate | Validate XML well-formedness + optional XSD schema. Errors with line/column. XXE-safe. |
sitemap_extract | Fetch + parse XML sitemaps. SSRF-protected. Optional recursive expansion of sub-sitemaps. lastmod/changefreq/priority metadata. |
stats | Descriptive statistics for a list of numbers — mean / median / mode / stddev / variance / percentiles / IQR / geometric / harmonic. |
number_base | Convert integers between bases 2..36 + Roman numerals. Big-int safe via GMP. |
finance_calc | Multi-mode financial calculations: loan, compound interest, simple interest, discount, tip, sales tax, ROI, percentage, markup. |
aspect_ratio | Compute reduced aspect ratio (16:9, 4:3, 21:9, ...) from width × height, or scale a dimension to a target ratio. |
color_convert | Convert any color into hex / rgb / rgba / hsl / hsv / cmyk + closest named color + WCAG luminance and contrast (AA / AAA flags). |
| MCP tool name | What it does |
|---|---|
timestamp | Bidirectional epoch ↔ ISO 8601 ↔ RFC 3339 ↔ human. Auto-detects epoch resolution (seconds, ms, µs, ns). Timezone-aware. Accepts natural language ("next monday", "+2 weeks"). |
date_math | Add/subtract a duration from a date, or compute the diff between two dates. Optional business-day count (Mon–Fri). |
age_calc | Calculate age in years/months/days from DOB. Returns next birthday, days until, Western zodiac sign, generation label, total days/seconds. |
The catalog grows over time. npx -y @mate-tools/mcp-server always fetches the latest published version — your client just needs a restart to pick up new tools.
Open the Claude Desktop config file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonAdd a mcpServers entry:
{
"mcpServers": {
"mate-tools": {
"command": "npx",
"args": ["-y", "@mate-tools/mcp-server"]
}
}
}Save, restart Claude Desktop, and all 27 mate-tools tools will appear in the tools picker. No manual download, no global install.
claude mcp add mate-tools npx -- -y @mate-tools/mcp-serverAdd to ~/.cursor/mcp.json:
{
"mcpServers": {
"mate-tools": {
"command": "npx",
"args": ["-y", "@mate-tools/mcp-server"]
}
}
}The server speaks MCP over stdio with the standard JSON-RPC 2.0 framing. Any MCP-compatible client can launch it as a subprocess with the same configuration shape as above.
npm: @mate-tools/mcp-server · single file, zero dependencies, Node 18+, MIT-licensed.
Calls the public mate.tools API over HTTPS. Nothing runs locally besides the JSON-RPC plumbing.
Prefer to vendor the source? Download server.js directly and reference its absolute path with "command": "node" instead.
For testing against a staging mate.tools deployment:
MATE_TOOLS_API_BASE=https://staging.mate.tools/api/v1 npx -y @mate-tools/mcp-serverOnce installed, ask your AI agent any of these:
secret with SHA-256 and Blake2b."correct horse battery staple."#ff5733 to all common color spaces and tell me the WCAG contrast vs white."https://example.com/sitemap.xml recursively."The agent will call the relevant tool automatically based on the request.
The server is part of mate.tools. Source above. Free to copy, fork or vendor. Issues or feature requests: /contact.