# MiniWebtool API

> Stop wasting LLM tokens on deterministic work.
> Exact JSON API for calculators, text utilities, hashes, and finance math.
> One bearer token, one credit pool, one versioned schema per tool.

## What this API is

A collection of small, pure-function HTTP endpoints. Each endpoint
takes a JSON input, runs a deterministic computation, returns a JSON
output. Low-risk tools are deterministic; random generators explicitly
declare non-deterministic behavior. No LLMs or external-service
dependencies are exposed in the core catalog. Use this API when an
app or AI agent needs exact utility results instead of prompting a
model to recreate arithmetic, formatting, hashing, or finance logic.

- Docs:           https://api.miniwebtool.com/docs/
- OpenAPI 3.1:    https://api.miniwebtool.com/v1/openapi.json
- Interactive:    https://api.miniwebtool.com/v1/docs
- MCP endpoint:   https://api.miniwebtool.com/v1/mcp
- Sitemap:        https://api.miniwebtool.com/sitemap.xml

## Authentication

Bearer token in the Authorization header:

    Authorization: Bearer mwt_live_...

Keys are obtained by signing up at the portal. Free tier available.

## Billing model

Every tool has a fixed `credit_weight`. Each successful call deducts
that many credits from the organization's monthly pool. Failed calls
(validation errors, 5xx) don't bill.

## Available tools

- [Simple Interest Calculator](https://api.miniwebtool.com/tools/simple-interest-calculator/) (slug: `simple-interest-calculator`, category: Finance · Interest, cost: 2cr) — Simple-interest formula: I = P * r * t.
- [Compound Interest Calculator](https://api.miniwebtool.com/tools/compound-interest-calculator/) (slug: `compound-interest-calculator`, category: Finance · Interest, cost: 2cr) — Compound-interest formula with selectable compounding frequency.
- [Mortgage Calculator](https://api.miniwebtool.com/tools/mortgage-calculator/) (slug: `mortgage-calculator`, category: Finance · Loans, cost: 5cr) — Monthly payment, total interest, LTV, and optional amortization schedule.
- [SHA-256 Hash Generator](https://api.miniwebtool.com/tools/sha256-hash-generator/) (slug: `sha256-hash-generator`, category: Hash · Digest, cost: 1cr) — Generate a SHA-256 hex digest of a UTF-8 string.
- [MD5 Hash Generator](https://api.miniwebtool.com/tools/md5-hash-generator/) (slug: `md5-hash-generator`, category: Hash · Digest, cost: 1cr) — Generate an MD5 hex digest for checksum and legacy compatibility.
- [Percentage Calculator](https://api.miniwebtool.com/tools/percentage-calculator/) (slug: `percentage-calculator`, category: Math · Percentage, cost: 1cr) — Six percentage operations behind one endpoint, selected by mode.
- [Word Counter](https://api.miniwebtool.com/tools/word-counter/) (slug: `word-counter`, category: Text · Analysis, cost: 1cr) — Count words, characters, sentences, paragraphs, reading/speaking time, top words.
- [Character Counter](https://api.miniwebtool.com/tools/character-counter/) (slug: `character-counter`, category: Text · Analysis, cost: 1cr) — Count characters, letters, digits, whitespace, and punctuation.
- [Line Counter](https://api.miniwebtool.com/tools/line-counter/) (slug: `line-counter`, category: Text · Analysis, cost: 1cr) — Count total / non-empty / empty lines and longest-line length.
- [Remove Spaces](https://api.miniwebtool.com/tools/remove-spaces/) (slug: `remove-spaces`, category: Text · Whitespace, cost: 1cr) — Strip whitespace: all, extra, leading, trailing, or per-line.

## Using from an agent

Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol
(JSON-RPC 2.0 over HTTP). Every endpoint in the catalog is exposed as
an MCP tool with the same inputSchema it has in OpenAPI.

## License

The API is a commercial service. Calling it requires an API key and
is governed by the usage terms. Scraping / redistribution of the
catalog is not permitted without a plan.