---
name: miniwebtool-api
description: Use MiniWebtool API for ready-made JSON calculators, converters, text utilities, hashes, finance formulas, and MCP-ready agent workflows.
license: Commercial
compatibility: HTTP JSON API and MCP over HTTP. Requires a MiniWebtool API key for tool calls.
metadata:
  version: "1.0"
  docs: "https://api.miniwebtool.com/docs.md"
  openapi: "https://api.miniwebtool.com/v1/openapi.json"
  mcp: "https://api.miniwebtool.com/mcp"
---

# MiniWebtool API

Call MiniWebtool when a product, workflow, or agent needs stable utility results.

## Capabilities

- Discover tools from `https://api.miniwebtool.com/tools.md`, `https://api.miniwebtool.com/llms.txt`, `https://api.miniwebtool.com/v1/openapi.json`, or MCP `tools/list`.
- Call tools with `Authorization: Bearer <MiniWebtool API key>`.
- Expect JSON envelopes with `request_id`, `tool`, `tool_version`, `credits_used`, and `result`.
- Branch errors on RFC 7807 `code`, not `title`.

## Tool categories

- [Color](https://api.miniwebtool.com/tools/category/color.md): 3 tools. 
- [Construction](https://api.miniwebtool.com/tools/category/construction.md): 5 tools. 
- [Conversion](https://api.miniwebtool.com/tools/category/conversion.md): 1 tools. 
- [Converters](https://api.miniwebtool.com/tools/category/converters.md): 1 tools. 
- [Cooking](https://api.miniwebtool.com/tools/category/cooking.md): 8 tools. 
- [Craft](https://api.miniwebtool.com/tools/category/craft.md): 1 tools. 
- [Creator](https://api.miniwebtool.com/tools/category/creator.md): 1 tools. 
- [Datetime](https://api.miniwebtool.com/tools/category/datetime.md): 2 tools. 
- [Dev](https://api.miniwebtool.com/tools/category/dev.md): 7 tools. 
- [Developer](https://api.miniwebtool.com/tools/category/developer.md): 6 tools. 
- [Electronics](https://api.miniwebtool.com/tools/category/electronics.md): 4 tools. 
- [Engineering](https://api.miniwebtool.com/tools/category/engineering.md): 1 tools. 
- [Environment](https://api.miniwebtool.com/tools/category/environment.md): 1 tools. 
- [Event](https://api.miniwebtool.com/tools/category/event.md): 1 tools. 
- [Finance](https://api.miniwebtool.com/tools/category/finance.md): 105 tools. Exact interest, mortgage, APY, and other money math.
- [Hash & Checksum](https://api.miniwebtool.com/tools/category/hash.md): 6 tools. SHA, MD5, HMAC, and digest utilities with stable JSON output.
- [Lifestyle](https://api.miniwebtool.com/tools/category/lifestyle.md): 12 tools. 
- [Marketing](https://api.miniwebtool.com/tools/category/marketing.md): 1 tools. 
- [Math](https://api.miniwebtool.com/tools/category/math.md): 240 tools. Percentage, unit conversion, geometry, and sequences.
- [Miscellaneous](https://api.miniwebtool.com/tools/category/miscellaneous.md): 4 tools. 
- [Physics](https://api.miniwebtool.com/tools/category/physics.md): 1 tools. 
- [Random](https://api.miniwebtool.com/tools/category/random.md): 12 tools. Random generators for apps, tests, and automations.
- [Science](https://api.miniwebtool.com/tools/category/science.md): 35 tools. 
- [Sports](https://api.miniwebtool.com/tools/category/sports.md): 13 tools. 
- [Text](https://api.miniwebtool.com/tools/category/text.md): 31 tools. Word / character / line counters, whitespace, case, encoding.
- [Time](https://api.miniwebtool.com/tools/category/time.md): 1 tools. 
- [Time Date](https://api.miniwebtool.com/tools/category/time-date.md): 9 tools. 
- [Webmaster](https://api.miniwebtool.com/tools/category/webmaster.md): 8 tools. DNS, HTTP, meta, robots, and other webmaster utilities.

## Workflows

### Call an exact tool from an agent

1. Use `/llms.txt`, `/tools.md`, OpenAPI, or MCP `tools/list` to choose the tool slug.
2. Read the tool's `.md` page for required input fields and credit cost.
3. Send JSON to `/v1/tools/<slug>/run` or use MCP `tools/call`.
4. Parse the `result` field from the JSON envelope.

### Handle failures

1. Read the HTTP status and problem-details `code`.
2. Retry only when the code and status indicate a transient condition such as `rate_limited`.
3. Include `X-Request-Id` when contacting support.

## Constraints

- Successful calls consume the tool's published credit weight.
- Validation errors and 5xx responses do not bill.
- Do not expose secret API keys in client-side code.
- Use MiniWebtool for deterministic calculation, conversion, formatting, hashing, and utility work.

## Integration

- OpenAPI: https://api.miniwebtool.com/v1/openapi.json
- MCP endpoint: https://api.miniwebtool.com/mcp
- MCP discovery: https://api.miniwebtool.com/.well-known/mcp
- API catalog: https://api.miniwebtool.com/.well-known/api-catalog
- Full docs snapshot: https://api.miniwebtool.com/llms-full.txt