alliotools-mcp

Privacy-first MCP server for allio Tools — 176+ utilities that run entirely on your machine.

No API keys. No accounts. No data leaves your device.

What is this?

Model Context Protocol (MCP) is an open standard that lets code editors and chat applications connect to external tool servers. This package brings allio Tools' calculators, converters, developer tools, text utilities, and date/time tools directly into any MCP-compatible client — running entirely as a local process on your machine.

Privacy first: Every tool in this server computes results locally in Node.js. Nothing is sent to allio.tools or any third-party service. The only exceptions are the network tools (marked with 🌐), which make external calls by design — for example, a DNS lookup must contact a DNS server.

Update checks — what this server does and doesn't send

This server checks at most once every 24 hours whether a newer version of alliotools-mcp is available, so you find out about new tools, improvements, and bug fixes without having to manually check npm. This check is completely separate from tool usage:

• It's a single anonymous GET of a static, public JSON file (changelog.json) hosted on this project's own GitHub repo — nothing about how you use the tools (which tools, what arguments, what results) is ever read or sent.
• It never blocks or slows down a tool call — the check runs in the background, and if it hasn't finished (or the machine is offline) a tool just runs normally with no update notice.
• If a newer version exists, a short notice is appended to the next tool result so you (or your AI assistant) see it inline — no popups, no separate process.
• The only thing written locally is a small cache file at ~/.alliotools-mcp/update-check.json (just a timestamp + the latest known version) so the check doesn't re-run on every single tool call.

Tools included

Calculators (local ✓)

| Tool | Description | |---|---| | percentage_calculator | X% of Y, X is what % of Y, percentage change | | compound_interest_calculator | Final amount, interest earned, year-by-year breakdown | | bmi_calculator | BMI and weight category (metric or imperial) | | age_calculator | Exact age in years/months/days + next birthday | | tip_calculator | Tip amount and split between people | | discount_calculator | Discounted price and amount saved | | profit_margin_calculator | Gross margin and markup percentage | | salary_calculator | Convert between hourly/daily/weekly/monthly/annual | | loan_calculator | Monthly payment and total interest | | break_even_calculator | Break-even units and revenue | | markup_calculator | Selling price from markup or markup from price | | area_calculator | Area of 8 shapes: rectangle, circle, triangle… | | fuel_cost_calculator | Trip fuel cost (metric or imperial) | | inflation_calculator | Inflation-adjusted value 1913–2024 (embedded CPI data) | | calorie_calculator | TDEE, BMR, and macro targets |

Converters (local ✓)

| Tool | Description | |---|---| | unit_converter | Length, weight, temperature, volume, speed, area, data | | number_base_converter | Binary ↔ Octal ↔ Decimal ↔ Hex | | roman_numeral_converter | Roman numerals ↔ integers (1–3999) | | number_to_words | 1234 → "one thousand two hundred thirty-four" | | color_converter | HEX ↔ RGB ↔ HSL ↔ HSV ↔ CMYK |

Developer Tools (local ✓)

| Tool | Description | |---|---| | base64_encode_decode | Encode/decode Base64 | | hash_generator | MD5, SHA-1, SHA-256, SHA-384, SHA-512 | | uuid_generator | Generate 1–100 UUIDs (v4, cryptographically random) | | json_formatter | Format, minify, or validate JSON | | url_encoder_decoder | Encode/decode URLs and URL components | | html_encoder_decoder | Encode/decode HTML entities | | regex_tester | Test regex patterns with match positions and groups | | jwt_decoder | Decode JWT header and payload, check expiry | | timestamp_converter | Unix timestamp ↔ human-readable date | | sql_formatter | Format and beautify SQL queries | | text_minifier | Minify CSS, JavaScript, or HTML | | hex_rgb_converter | HEX ↔ RGB color conversion | | cron_parser | Parse cron expressions in plain English + next 5 runs |

Text Tools (local ✓)

| Tool | Description | |---|---| | word_counter | Words, characters, sentences, paragraphs, reading time | | case_converter | UPPER, lower, Title, camelCase, snake_case, kebab-case, PascalCase | | text_diff | Line-by-line diff between two texts | | lorem_ipsum_generator | Generate placeholder text (paragraphs/sentences/words) | | text_to_slug | Convert text to URL-friendly slug | | palindrome_checker | Check if text reads the same forwards and backwards | | text_reverser | Reverse by characters, words, or lines | | duplicate_line_remover | Remove duplicate lines from text | | text_sorter | Sort lines alphabetically, by length, or randomly | | morse_code_converter | Text ↔ Morse code | | character_counter | Character count with frequency breakdown |

Date & Time (local ✓)

| Tool | Description | |---|---| | date_calculator | Days between dates, add/subtract days | | time_zone_converter | Convert times between any IANA time zones | | unix_timestamp_converter | Unix timestamp ↔ human-readable | | week_number_calculator | ISO week number and week date range | | time_duration_calculator | Duration between times, add durations |

Network Tools (🌐 makes external calls)

These tools work by contacting external services. No data is stored or logged by allio Tools — the call goes directly from your machine to the target.

| Tool | External call made | |---|---| | dns_lookup | DNS query to resolve A, MX, TXT, NS records | | http_header_checker | HTTP HEAD request to target URL | | website_status_checker | HTTP request to check if site is up | | ip_address_lookup | DNS lookup + optional geolocation API | | open_graph_preview | HTTP GET to extract OG/Twitter Card meta tags |

Installation & Setup

Prerequisites

• Node.js v18 or higher

No other dependencies. No API keys. No configuration files.

Claude Desktop

Edit ~/AppData/Roaming/Claude/claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

{
  "mcpServers": {
    "alliotools": {
      "command": "npx",
      "args": ["-y", "alliotools-mcp"]
    }
  }
}

Restart Claude Desktop. You'll see "alliotools" in the tools panel.

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "alliotools": {
      "command": "npx",
      "args": ["-y", "alliotools-mcp"]
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "alliotools": {
      "command": "npx",
      "args": ["-y", "alliotools-mcp"]
    }
  }
}

VS Code (with Cline, Roo Code, or Continue)

Add to your .vscode/mcp.json or the extension's config file:

{
  "mcpServers": {
    "alliotools": {
      "command": "npx",
      "args": ["-y", "alliotools-mcp"]
    }
  }
}

Zed

In ~/.config/zed/settings.json:

{
  "context_servers": {
    "alliotools": {
      "command": {
        "path": "npx",
        "args": ["-y", "alliotools-mcp"]
      }
    }
  }
}

Amazon Q Developer

Edit ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "alliotools": {
      "command": "npx",
      "args": ["-y", "alliotools-mcp"]
    }
  }
}

GitHub Copilot (VS Code agent mode)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "alliotools": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "alliotools-mcp"]
    }
  }
}

JetBrains AI

Go to Settings → Tools → AI Assistant → Model Context Protocol and add:

• Command: npx
• Arguments: -y alliotools-mcp

Privacy

This MCP server was built with privacy as the primary design constraint.

• Local tools (all calculators, converters, developer tools, text tools, date/time tools): All computation happens in the Node.js process on your machine. No network requests are made. No data is transmitted anywhere.
• Network tools (DNS lookup, HTTP header checker, website status, IP lookup, OG preview): These tools exist to query external resources — that's their purpose. The request goes directly from your machine to the target. allio Tools never sees the request.
• No telemetry. No analytics. No usage tracking. No crash reporting.
• Open source. You can read every line of this code and verify it yourself.

Using with your AI

Once installed, just ask naturally:

• "Calculate compound interest on $10,000 at 5% for 20 years, compounded monthly"
• "Convert 180 lbs to kg"
• "How many days between March 15 2024 and November 30 2024?"
• "Generate 5 UUIDs"
• "What is the SHA-256 hash of 'hello world'?"
• "Convert 9:30 AM New York time to London time"
• "Look up DNS records for allio.tools"
• "Is https://example.com up?"

License

MIT — see LICENSE

Built with ❤️ by allio Tools — free online tools for everyone.