Refineo AI Text Humanizer CLI - Transform AI-generated text into natural human writing
npm install refineo-cli

CLI and MCP tools for Refineo - Transform AI-generated text into natural human writing.
``bashUsing bunx (recommended)
bunx refineo-cli login
$3
`bash
Using uvx (recommended)
uvx refineo-cli loginUsing pipx
pipx run refineo-cli loginGlobal install
pip install refineo-cli && refineo login
`Commands
`bash
refineo login # Authenticate with your account
refineo logout # Clear stored credentials
refineo stats # Show usage statistics
refineo humanize "text" # Humanize AI-generated text
`$3
`bash
refineo humanize "text" --model enhanced # Use enhanced model (default)
refineo humanize "text" --model standard # Use standard model
refineo humanize --file input.txt # Read from file
refineo humanize --file input.txt --output output.txt # Write to file
refineo humanize "text" --verbose # Show debug output
echo "text" | refineo humanize # Read from stdin
`Requirements
- Pro or Ultra subscription - CLI/MCP access is a Pro+ feature
- Node.js 18+ (for Node CLI)
- Python 3.10+ (for Python CLI)
Authentication
The CLI uses device code flow for secure authentication:
1. Run
refineo login
2. A browser opens to authorize the device
3. Sign in and confirm the device code
4. Credentials are stored securely in ~/.refineo/MCP Integration
Refineo provides an MCP server for integration with Claude Desktop, Cursor, and other AI assistants.
$3
| Tool | Description |
|------|-------------|
|
humanize_text | Transform AI-generated text into natural human writing |
| get_usage | Check remaining quota for current billing period |$3
Option 1: API Key (Recommended for MCP)
API keys are long-lived (7 days to 1 year) and don't require refresh. Create one at www.refineo.app/dashboard/api-keys.
Option 2: Bearer Token
Use the CLI to get a short-lived access token (15 minutes). Suitable for quick testing.
$3
Run this command (replace
sk_your_api_key with your actual key):`bash
claude mcp add-json refineo '{"type":"http","url":"https://www.refineo.app/mcp/mcp","headers":{"X-API-Key":"sk_your_api_key"}}'
`$3
1. Open Claude Desktop → Settings → Connectors
2. Click "Add custom connector"
3. Enter URL:
https://www.refineo.app/mcp/mcp
4. Click Add → Sign in with your Refineo accountNo API key needed - uses OAuth authentication.
$3
Alternatively, use an API key with the config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json`json
{
"mcpServers": {
"refineo": {
"command": "npx",
"args": [
"mcp-remote",
"https://www.refineo.app/mcp/mcp",
"--header",
"X-API-Key:sk_your_api_key_here"
]
}
}
}
`> Requires Node.js. Uses mcp-remote as a proxy.
$3
- API Keys: No refresh needed until expiry (7d-1y). Create new keys at dashboard/api-keys.
- Bearer Tokens: Expire after 15 minutes. Run
refineo login to refresh.Development
$3
`bash
cd node
npm install
npm run build
npm start login
`$3
`bash
cd python
pip install -e ".[dev]"
refineo login
``- Refineo App
- Pricing
- Manage API Keys
- Manage Connected Devices
MIT