Tool Reference
==============

ApiCrate exposes 21 tools across 8 domains. Each tool is prefixed with
``apicrate-`` to prevent collisions when connecting multiple MCP servers.

.. list-table:: All Tools
   :widths: 40 10 50
   :header-rows: 1

   * - Tool
     - Credits
     - Description
   * - **User Agents**
     -
     -
   * - ``apicrate-parse-user-agent``
     - 2
     - Parse a User-Agent string into structured device, browser, and OS data.
   * - ``apicrate-parse-user-agents-bulk``
     - 1 / UA
     - Parse up to 100 User-Agent strings in a single call.
   * - **IP Geolocation**
     -
     -
   * - ``apicrate-geolocate-ip``
     - 5
     - Geolocate an IP address (country, city, ISP, VPN detection).
   * - **Countries**
     -
     -
   * - ``apicrate-lookup-country``
     - 1
     - Look up a country by ISO alpha-2, alpha-3, or numeric code.
   * - ``apicrate-search-countries``
     - 3
     - Search or filter countries by region, sub-region, or name.
   * - ``apicrate-validate-country-codes``
     - 1 / code
     - Validate one or more ISO 3166-1 country codes (max 50).
   * - **Postal Codes**
     -
     -
   * - ``apicrate-lookup-postal-code``
     - 2
     - Look up a postal code for places and coordinates.
   * - ``apicrate-validate-postal-code``
     - 1
     - Validate a postal code against a country's format regex.
   * - ``apicrate-search-postal-codes``
     - 3
     - Search postal codes by place name or code prefix.
   * - ``apicrate-list-postal-systems``
     - 2
     - List countries with postal code data and their formats.
   * - ``apicrate-get-postal-system``
     - 2
     - Get postal system details for a specific country.
   * - ``apicrate-validate-postal-codes-bulk``
     - 2 / code
     - Validate multiple postal codes with format and existence checks (max 50).
   * - ``apicrate-find-nearby-postal-codes``
     - 5
     - Find postal codes near a geographic point, ordered by distance.
   * - **Timezones**
     -
     -
   * - ``apicrate-get-timezone-info``
     - 1
     - Get current time, UTC offset, and DST status for a timezone.
   * - ``apicrate-convert-time``
     - 1
     - Convert a time from one timezone to another.
   * - **Hashing**
     -
     -
   * - ``apicrate-compute-hash``
     - 1
     - Compute a cryptographic digest (MD5, SHA-1, SHA-256, SHA-512).
   * - ``apicrate-hash-password``
     - 2
     - Hash a password with a slow KDF (bcrypt, scrypt, argon2id).
   * - **Bible**
     -
     -
   * - ``apicrate-get-bible-verse``
     - 1
     - Retrieve a verse or verse range from 30+ translations.
   * - ``apicrate-search-bible``
     - 3
     - Search the Bible for verses matching a keyword or phrase.
   * - **Email Risk**
     -
     -
   * - ``apicrate-check-email-risk``
     - 4
     - Validate an email and compute a fraud risk score.
   * - ``apicrate-check-email-risk-bulk``
     - 4 / email
     - Validate up to 10 emails with risk scores in one call.

.. toctree::
   :maxdepth: 2

   user-agents
   ip
   countries
   postal
   timezones
   hashing
   bible
   email