io.usefulapi/numeral
REMOTE · NUMERAL.USEFULAPI.IO · SCANNED AUG 3
Calculate sales tax & VAT, record transactions and refunds, manage products and customers.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes. View diagnostics → Unverified
- HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability0
- Transport check failed: declared streamable-http, but the endpoint returned HTTP 429. See how to fix → View diagnostics → Fail
Schema Quality & AI Usability0
- Schema not yet verified: we couldn't read the endpoint's schema.Unverified
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
- Tool coverage not yet verified: we couldn't read the endpoint's tools.Unverified
Capabilities0
- Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified
Unverified: 4 categories
Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · numeral.usefulapi.io
claude mcp add --transport http io-usefulapi-numeral https://numeral.usefulapi.io/mcp
[mcp_servers.io-usefulapi-numeral] url = "https://numeral.usefulapi.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"io-usefulapi-numeral": {
"type": "remote",
"url": "https://numeral.usefulapi.io/mcp",
"enabled": true
}
}
} openclaw mcp add io-usefulapi-numeral --url https://numeral.usefulapi.io/mcp --transport streamable-http
mcp_servers:
io-usefulapi-numeral:
url: "https://numeral.usefulapi.io/mcp" {
"mcpServers": {
"io-usefulapi-numeral": {
"type": "http",
"url": "https://numeral.usefulapi.io/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 1 Aug 26 −53
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.13 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Capabilities: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 31 Jul 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Jul 26 +1
- Stability: unverified → 0.03 ▲ functional
- 27 Jul 26 +56
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 12
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://numeral.usefulapi.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=usefulapi.io | CN=WE1,O=Google Trust Services,C=US | 19 Jul 2026 | 17 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | f3886899c43cacbe13984ee09ea259a5 |
| SANs: usefulapi.io, numeral.usefulapi.io, *.numeral.usefulapi.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC insecure
Validation of numeral.usefulapi.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| io. | present | 57355 | 8 | Verified |
| usefulapi.io. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 429 |
| Header | Value |
|---|---|
| x-frame-options | SAMEORIGIN |
| referrer-policy | same-origin |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://numeral.usefulapi.io/mcp | HTTP error | 429 | |
| http (plaintext) | http://numeral.usefulapi.io/mcp | Inconclusive | 429 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
numeral_calculate_tax Calculate tax ~170
Calculate sales tax / VAT for an order — a STATELESS quote that persists nothing (record it later with numeral_create_transaction using the returned calculation id). Returns per-jurisdiction rates, total_tax_amount, and totals. Provide a customer address and one or more line items (each needs reference_product_id OR product_category). Amounts are in the currency's smallest unit (cents). Numeral: POST /tax/calculations.
| Name | Type | Req | Description |
|---|---|---|---|
| customer | object | yes | Customer details — address is required. |
| metadata | object | — | Arbitrary string key/value metadata. |
| order_details | object | yes | Order details. |
| origin_address | object | — | The address a product ships from. Optional on 2024-09-01; required on API version 2025-05-12+. |
No output schema declared.
No examples provided.
numeral_create_customer Create customer ~99
CREATES a customer record — this WRITES to your Numeral customer list (used for order tracking and tax exemptions). Numeral: POST /tax/customers.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | Customer email (required). | |
| is_tax_exempt | boolean | — | Whether this customer is tax exempt. |
| name | string | — | Customer name. |
| reference_customer_id | string | — | Your own id for this customer (for reference-based lookups). |
No output schema declared.
No examples provided.
numeral_create_product Create product ~112
CREATES (or upserts) a product with its tax category — this WRITES to your Numeral product catalog, which drives future tax calculations. Numeral: POST /tax/products.
| Name | Type | Req | Description |
|---|---|---|---|
| product_category | string | yes | A tax category from Numeral's taxonomy, e.g. "GENERAL_MERCHANDISE", "SAAS_GENERAL". |
| reference_product_id | string | yes | Your product id (used to reference this product in calculations). |
| reference_product_name | string | yes | Human-readable product name. |
No output schema declared.
No examples provided.
numeral_create_refund Create refund ~155
RECORDS a refund against a transaction — this WRITES a live tax/compliance record (adjusts tax owed). Use type="full" to refund the whole transaction, or type="partial" with line_items (each keyed by reference_product_id) for a partial refund. Numeral: POST /tax/refunds.
| Name | Type | Req | Description |
|---|---|---|---|
| line_items | array | — | Required for type="partial": the line items to refund. |
| refund_processed_at | number | — | Unix timestamp (SECONDS) the refund was made. Defaults to now if omitted. |
| transaction_id | string | yes | The transaction id (tr_...) to refund. |
| type | string | yes | "full" refunds the whole transaction; "partial" requires line_items. |
No output schema declared.
No examples provided.
numeral_create_transaction Create transaction ~137
RECORDS a completed sale as a transaction — this WRITES a live tax/compliance record used for filings. Supply the `calculation_id` returned by numeral_calculate_tax and your `reference_order_id`. Numeral: POST /tax/transactions.
| Name | Type | Req | Description |
|---|---|---|---|
| calculation_id | string | yes | The calculation id returned by numeral_calculate_tax. |
| metadata | object | — | Arbitrary string key/value metadata. |
| reference_order_id | string | yes | Your order id for this sale (used for record keeping / dedupe). |
| transaction_processed_at | number | — | Unix timestamp (SECONDS) the sale was processed. Defaults to now if omitted. |
No output schema declared.
No examples provided.
numeral_get_customer Get customer ~124
Get a customer by id. By default `customer_id` is the Numeral id (cus_...); set id_type to "reference" to look up by your own reference_customer_id. Returns name, email, and tax-exempt status. Numeral: GET /tax/customers/{customer_id}.
| Name | Type | Req | Description |
|---|---|---|---|
| customer_id | string | yes | The customer id — a Numeral id (cus_...) by default, or your reference id when id_type="reference". |
| id_type | string | — | Which id space `customer_id` is in (default: numeral). |
No output schema declared.
No examples provided.
numeral_get_product Get product ~69
Get a single product by its reference_product_id (your id). Returns the product's name, product_category, and timestamps. Numeral: GET /tax/products/{reference_product_id}.
| Name | Type | Req | Description |
|---|---|---|---|
| reference_product_id | string | yes | Your product id (the reference_product_id used when the product was created). |
No output schema declared.
No examples provided.
numeral_get_transaction Get transaction ~64
Get a recorded transaction by its Numeral id (tr_...). Returns the transaction with its line items, currencies, and metadata. Numeral: GET /tax/transactions/{transaction_id}.
| Name | Type | Req | Description |
|---|---|---|---|
| transaction_id | string | yes | The Numeral transaction id (tr_...). |
No output schema declared.
No examples provided.
numeral_list_products List products ~84
List your Numeral products (up to 50 per page), each with its reference id, name, and product_category. Use `cursor` (the last_product_id from a previous page) to paginate; has_more indicates more pages. Numeral: GET /tax/products.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | — | Pagination cursor — pass the last_product_id from the previous page. |
No output schema declared.
No examples provided.
numeral_list_transaction_refunds List transaction refunds ~58
List all refunds recorded against a transaction. Returns {refunds:[...]}. Numeral: GET /tax/transactions/{transaction_id}/refunds.
| Name | Type | Req | Description |
|---|---|---|---|
| transaction_id | string | yes | The Numeral transaction id (tr_...). |
No output schema declared.
No examples provided.
numeral_ping Ping (health check) ~41
Health check — verifies the API key works and reports the environment (test/prod), api_version, and server timestamp. Numeral: GET /tax/ping.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.