$Numbers API logo$

Math Tools Numbers API

Name: Numbers API
Brand: Numbers API
Availability: InStock

✓ Official Vendor SpecDeveloper ToolsTesting QaapiKey26 EndpointsREST

For Agents

Spell numbers as words, convert between bases and numeral systems, generate random numbers, and run prime/factor checks via small math utility endpoints.

Install Jentic One Beta

Connect the Numbers API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Numbers API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Numbers API.

Spell a number as its cardinal or ordinal English form

Convert a number between binary, octal, decimal, and hexadecimal bases

Convert numbers to alternative numeral systems including Roman, Egyptian, and Chinese

GET STARTED

Start building with Numbers API

Explore with Jentic

View OpenAPI Document

The Numbers API by math.tools provides a focused set of math utilities exposed as REST endpoints, including number-of-the-day, number facts, random-number generation, ordinal and cardinal spelling, base conversion, alternative numeral systems (Egyptian, Chinese, Roman), prime checks, and pi digits. Each endpoint is a small computation rather than a heavy mathematical engine, which makes it well suited to embedding inside chat experiences, educational tools, and small utilities. Authentication uses the `X-Mathtools-Api-Secret` header.

Use Cases

Patterns agents use Numbers API for, with concrete tasks.

★ Educational Math Widgets

Educational sites and homework apps embed small interactive widgets that demonstrate base conversion, prime checks, and number spelling. The Numbers API returns the computed result in a single GET so the widget can render the answer without shipping a math library to the client. Each call typically completes in under 200ms.

Call `GET /numbers/cardinal?number=1234` and render the spelled-out form '1234' for the student.

Trivia and Chat Bot Number Facts

Trivia bots and conversational assistants enrich number-related queries with the 'number of the day' and per-number facts. The Numbers API's `/numbers/fact` and `/numbers/nod` endpoints return short text snippets ready to drop into a reply, removing the need to build a fact corpus from scratch.

Call `GET /numbers/fact?number=42` and quote the returned fact in the chat reply.

Numeral System Converter

Tools that teach historical numeral systems (Roman, Egyptian, Chinese) need authoritative conversions between Hindu-Arabic numerals and the target system. The Numbers API exposes each numeral system as a dedicated endpoint, returning the converted glyphs without requiring local font handling beyond rendering Unicode.

Call `GET /numbers/numeral/roman?number=2026` and render the result 'MMXXVI' in the converter UI.

AI Agent Number Helper

An AI assistant occasionally needs to spell a check amount, convert a hex colour value, or verify whether a value is prime — operations LLMs can do unreliably for large inputs. Jentic exposes the Numbers API behind intent-based discovery so the agent offloads these computations to a deterministic service and stores the API key securely.

Search Jentic for 'spell number as words', load the `/numbers/cardinal` schema, and execute it with number=1234 to return the spelled form deterministically.

Key Endpoints

26 endpoints — the numbers api by math.

METHOD

PATH

DESCRIPTION

GET

/numbers/cardinal

Spell a number as its cardinal English form

GET

/numbers/ordinal

Spell a number as its ordinal English form

GET

/numbers/fact

Retrieve a fact for a number

GET

/numbers/nod

Number of the day

GET

/numbers/random

Generate a random number

GET

/numbers/numeral/roman

Convert a number to Roman numerals

GET

/numbers/numeral/egyptian

Convert a number to Egyptian numerals

GET

/numbers/numeral/chinese

Convert a number to Chinese numerals

GET

/numbers/cardinal

Spell a number as its cardinal English form

GET

/numbers/ordinal

Spell a number as its ordinal English form

GET

/numbers/fact

Retrieve a fact for a number

GET

/numbers/nod

Number of the day

GET

/numbers/random

Generate a random number

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The math.tools `X-Mathtools-Api-Secret` is stored encrypted in the Jentic vault (MAXsystem) and applied to the request header at execution time. Agents receive scoped session references — the raw secret never enters the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'spell number as words' or 'convert number to roman numerals') and Jentic returns the matching math.tools operation with its query schema.

Time to first call

Direct math.tools integration: 1-2 hours for auth and small per-endpoint wiring. Through Jentic: a few minutes — search, load schema, execute.

FAQs

Specific to using Numbers API through Jentic.

What authentication does the Numbers API use?

math.tools authenticates via the `X-Mathtools-Api-Secret` header. Through Jentic, the secret is stored encrypted in the MAXsystem vault and applied to the request header at execution time so the agent never sees the raw value.

Can I convert numbers between bases with the Numbers API?

Yes. The `/numbers/cardinal` and `/numbers/ordinal` endpoints handle spelling, while the base-conversion endpoints under `/numbers/numeral/...` convert between binary, octal, decimal, hex, and historical systems like Roman, Egyptian, and Chinese.

What are the rate limits for the Numbers API?

math.tools does not publish hard rate limits in the spec. Treat it as a small utility API and apply conservative client-side throttling (a few requests per second per key) until you have confirmed quotas with the math.tools team.

How do I spell a number through Jentic?

Run `pip install jentic`, then use Jentic's search with the query 'spell number as words'. Jentic loads the `/numbers/cardinal` operation schema and your agent executes it with the integer to spell — the API secret is applied automatically.

Does the Numbers API support Roman numerals?

Yes. `GET /numbers/numeral/roman` converts an integer to its Roman numeral form, and the parallel `/numbers/numeral/egyptian` and `/numbers/numeral/chinese` endpoints handle other historical numeral systems.

Can I check whether a number is prime?

Yes. The endpoints under `/numbers/prime/...` cover primality checks; combine them with the broader `/numbers/check/...` endpoints for related properties such as factorisation.