← mate.tools API

mate.tools MCP server

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.

Currently exposed tools

MCP tool name	What it does
count_lines	Count lines, words, sentences, paragraphs, characters and more in a chunk of text. Returns 16 metrics including duplicate-line detection and Unix/Windows line-ending detection.

More tools will be added as the underlying API grows. Update by simply restarting your client — npx always pulls the latest published version.

Install in Claude Desktop

Open the Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add a mcpServers entry:

{
  "mcpServers": {
    "mate-tools": {
      "command": "npx",
      "args": ["-y", "@mate-tools/mcp-server"]
    }
  }
}

Save, restart Claude Desktop, and the six mate-tools tools will appear in the tools picker. No manual download, no global install.

Install in Claude Code

claude mcp add mate-tools npx -- -y @mate-tools/mcp-server

Install in Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mate-tools": {
      "command": "npx",
      "args": ["-y", "@mate-tools/mcp-server"]
    }
  }
}

Install in Windsurf / other MCP clients

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.

The package

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.

Override the API endpoint

For testing against a staging mate.tools deployment:

MATE_TOOLS_API_BASE=https://staging.mate.tools/api/v1 npx -y @mate-tools/mcp-server

Try it

Once installed in Claude Desktop, ask Claude:

"Use the count_lines tool to analyse this paragraph and tell me the reading time."

Claude will call count_lines with your text and report the metrics.

Source and licence

The server is part of mate.tools. Source above. Free to copy, fork or vendor. Issues or feature requests: /contact.