Utility Converter

Official7 tools

by punchfan01 · Python

7 utility tools in here: exchange rate, UUID, hash, Base64, timestamp, calculator, unit conversion.

Captured live from the server via tools/list.

get_exchange_rate

Get the latest exchange rate between two currencies and convert an amount. Uses the free Frankfurter API (no API key required). Currency codes must be ISO 4217 codes such as USD, KRW, EUR, JPY, GBP.

Parameters3

from_currency	string	required	Base currency code (e.g. "USD").
to_currency	string	required	Target currency code (e.g. "KRW").
amount	number	optional	Amount in the base currency to convert. Defaults to 1.0.

Raw schema

{
  "type": "object",
  "properties": {
    "from_currency": {
      "type": "string",
      "description": "Base currency code (e.g. \"USD\")."
    },
    "to_currency": {
      "type": "string",
      "description": "Target currency code (e.g. \"KRW\")."
    },
    "amount": {
      "default": 1,
      "type": "number",
      "description": "Amount in the base currency to convert. Defaults to 1.0."
    }
  },
  "required": [
    "from_currency",
    "to_currency"
  ],
  "additionalProperties": false
}

generate_uuid

Generate one or more random UUID v4 strings.

Parameters2

count	integer	optional	Number of UUIDs to generate (1-100). Defaults to 1.
uppercase	boolean	optional	If true, return UUIDs in uppercase. Defaults to false.

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "default": 1,
      "type": "integer",
      "description": "Number of UUIDs to generate (1-100). Defaults to 1."
    },
    "uppercase": {
      "default": false,
      "type": "boolean",
      "description": "If true, return UUIDs in uppercase. Defaults to false."
    }
  },
  "additionalProperties": false
}

hash_text

Compute the cryptographic hash of a UTF-8 text string.

Parameters2

text	string	required	The input text to hash.
algorithm	string	optional	One of "md5", "sha1", "sha256", "sha512". Defaults to "sha256".

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The input text to hash."
    },
    "algorithm": {
      "default": "sha256",
      "type": "string",
      "description": "One of \"md5\", \"sha1\", \"sha256\", \"sha512\". Defaults to \"sha256\"."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

encode_decode_base64

Encode text to Base64 or decode a Base64 string back to text.

Parameters2

text	string	required	The text to encode, or the Base64 string to decode.
mode	string	optional	Either "encode" or "decode". Defaults to "encode".

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text to encode, or the Base64 string to decode."
    },
    "mode": {
      "default": "encode",
      "type": "string",
      "description": "Either \"encode\" or \"decode\". Defaults to \"encode\"."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

convert_timestamp

Convert between Unix timestamps and human-readable datetimes.

Parameters3

value	string	required	For "to_datetime", a Unix timestamp in seconds (e.g. "1752300000"). For "to_timestamp", an ISO 8601 datetime (e.g. "2026-07-12 15:30:00"). The special value "now" returns the current time in both formats.
direction	string	optional	"to_datetime" or "to_timestamp". Defaults to "to_datetime".
tz	string	optional	IANA timezone name used for display/interpretation. Defaults to "Asia/Seoul".

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "string",
      "description": "For \"to_datetime\", a Unix timestamp in seconds (e.g. \"1752300000\").\nFor \"to_timestamp\", an ISO 8601 datetime (e.g. \"2026-07-12 15:30:00\").\nThe special value \"now\" returns the current time in both formats."
    },
    "direction": {
      "default": "to_datetime",
      "type": "string",
      "description": "\"to_datetime\" or \"to_timestamp\". Defaults to \"to_datetime\"."
    },
    "tz": {
      "default": "Asia/Seoul",
      "type": "string",
      "description": "IANA timezone name used for display/interpretation.\nDefaults to \"Asia/Seoul\"."
    }
  },
  "required": [
    "value"
  ],
  "additionalProperties": false
}

calculate

Revised July 13 at 11am Safely evaluate an arithmetic expression and return the exact result. Supports +, -, *, /, //, %, ** (power), parentheses, the constants pi and e, and the functions sqrt(), abs(), round(). Does not execute arbitrary code.

Parameters1

expression

string

required

An arithmetic expression, e.g. "(3 + 4) * 2 ** 5" or "sqrt(2) * pi".

Raw schema

{
  "type": "object",
  "properties": {
    "expression": {
      "type": "string",
      "description": "An arithmetic expression, e.g. \"(3 + 4) * 2 ** 5\" or\n\"sqrt(2) * pi\"."
    }
  },
  "required": [
    "expression"
  ],
  "additionalProperties": false
}

convert_units

Convert a value between units of length, weight, or temperature. Supported units: - Length: mm, cm, m, km, inch, ft, yard, mile - Weight: mg, g, kg, ton, oz, lb - Temperature: C, F, K (Celsius, Fahrenheit, Kelvin) Both units must belong to the same category (e.g. km -> mile is valid, kg -> mile is not).

Parameters3

value	number	required	The numeric value to convert.
from_unit	string	required	The source unit (e.g. "km").
to_unit	string	required	The target unit (e.g. "mile").

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "number",
      "description": "The numeric value to convert."
    },
    "from_unit": {
      "type": "string",
      "description": "The source unit (e.g. \"km\")."
    },
    "to_unit": {
      "type": "string",
      "description": "The target unit (e.g. \"mile\")."
    }
  },
  "required": [
    "value",
    "from_unit",
    "to_unit"
  ],
  "additionalProperties": false
}

README.md1 KBView on GitHub

Utility Converter MCP Server

A simple remote MCP server (Streamable HTTP, no authentication) providing 7 everyday utility tools.

Tools

get_exchange_rate — Latest currency exchange rates (Frankfurter API)
generate_uuid — Generate random UUID v4 strings
hash_text — MD5 / SHA1 / SHA256 / SHA512 text hashing
encode_decode_base64 — Base64 encode / decode
convert_timestamp — Unix timestamp ↔ human-readable datetime
calculate — Safe arithmetic expression evaluator
convert_units — Length / weight / temperature unit conversion

Run

bash

pip install -r requirements.txt
python server.py

Endpoint: http://localhost:8000/mcp

Install

Tools (7)

get_exchange_rategenerate_uuidhash_textencode_decode_base64convert_timestampcalculateconvert_units

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://utility-converter.onrender.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "utility-converter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://utility-converter.onrender.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Utility Converter - agentage MCP Catalog