v0.0.2

Changed

• Updated humantone SDK dependency from ^0.0.1 to ^0.0.2. See SDK v0.0.2 release notes for details.

Added

• Mapping for new SDK error code invalid_response_shape.

First public release of the official HumanTone MCP server. Use HumanTone's humanize and AI likelihood tools directly from Claude Desktop, Cursor, Cline, and other MCP clients.

Included

• Three MCP tools: humanize, detect_ai, get_account
• Stdio transport via @modelcontextprotocol/sdk
• Built on top of the humantone Node SDK
• Friendly error messages for common failure cases (authentication, plan limits, daily detection quota, invalid input)
• Compatible with Claude Desktop, Cursor, Cline, VSCode with GitHub Copilot agent mode, Codex CLI, Gemini CLI, Continue.dev, Zed, Windsurf, JetBrains AI Assistant, and any spec-compliant MCP client

Requirements

• Node.js 18 or later
• A paid HumanTone plan with API access
• An API key from https://app.humantone.io/settings/api

Install

No install step. The MCP client downloads the package on first launch via npx humantone-mcp.

Example config for Claude Desktop:

{
  "mcpServers": {
    "humantone": {
      "command": "npx",
      "args": ["-y", "humantone-mcp"],
      "env": {
        "HUMANTONE_API_KEY": "ht_your_api_key_here"
      }
    }
  }
}

See the README for setup snippets for Cursor, Cline, and other MCP clients.

Links

• npm: https://www.npmjs.com/package/humantone-mcp
• API docs: https://humantone.io/docs/api/
• HumanTone Node SDK: https://www.npmjs.com/package/humantone