---
name: miniwebtool-api
description: Use MiniWebtool API for exact 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

Use model tokens for reasoning and call MiniWebtool for deterministic utility work.

## 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

- [Construction](https://api.miniwebtool.com/tools/category/construction.md): 1 tools. 
- [Cooking](https://api.miniwebtool.com/tools/category/cooking.md): 1 tools. 
- [Dev](https://api.miniwebtool.com/tools/category/dev.md): 5 tools. 
- [Electronics](https://api.miniwebtool.com/tools/category/electronics.md): 1 tools. 
- [Finance](https://api.miniwebtool.com/tools/category/finance.md): 4 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.
- [Math](https://api.miniwebtool.com/tools/category/math.md): 96 tools. Percentage, unit conversion, geometry, and sequences.
- [Random](https://api.miniwebtool.com/tools/category/random.md): 2 tools. Random generators for apps, tests, and automations.
- [Science](https://api.miniwebtool.com/tools/category/science.md): 13 tools. 
- [Sports](https://api.miniwebtool.com/tools/category/sports.md): 1 tools. 
- [Text](https://api.miniwebtool.com/tools/category/text.md): 20 tools. Word / character / line counters, whitespace, case, encoding.

## 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 LLMs for reasoning and orchestration; 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