# Usefulapi Numeral MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.usefulapi%2Fnumeral
Registry id: `mcp-registry/io.usefulapi/numeral`
Status: auth-required (checked 2026-10-27T02:28:52.358Z)

## Verdict

Usefulapi Numeral MCP server answered 100% of Glimind's liveness checks over 30 days, better than 42% of MCP servers, with 64 ms median handshake and 0 outages in 90 days. Its agent-readiness grade is A (96/100) across 11 tools, costing an agent about 2,950 tokens to load. Checked every few minutes; no tool is ever called.

## Measurements (30 days)

| Metric | Value | Better than |
|---|---|---|
| Uptime, 30 days | 100% | 42% of MCP servers |
| Median handshake latency | 64 ms | 88% of MCP servers |
| p95 handshake latency | 262 ms | — |
| Checks in 30 days | 211 | — |
| Outages, 90 days | 0 | — |
| Median recovery | — | — |
| Agent-readiness score | 96/100 (A) | 82% of MCP servers |
| Tools | 11 | — |
| Tool-list size for an agent | ~2,950 tokens | 46% of MCP servers |
| Days observed | 27 | — |

## Install

```json
{
  "mcpServers": {
    "usefulapi-numeral-mcp-server": {
      "type": "http",
      "url": "https://numeral.usefulapi.io/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http usefulapi-numeral-mcp-server https://numeral.usefulapi.io/mcp
```

## Tools (11)

- `numeral_calculate_tax`: Calculate sales tax / VAT for an order — a STATELESS quote that persists nothing (record it later with numeral_create_transaction using the returned calculation
- `numeral_create_customer`: CREATES a customer record — this WRITES to your Numeral customer list (used for order tracking and tax exemptions). Numeral: POST /tax/customers.
- `numeral_create_product`: CREATES (or upserts) a product with its tax category — this WRITES to your Numeral product catalog, which drives future tax calculations. Numeral: POST /tax/pro
- `numeral_create_refund`: 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="
- `numeral_create_transaction`: 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
- `numeral_get_customer`: 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 nam
- `numeral_get_product`: 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_
- `numeral_get_transaction`: Get a recorded transaction by its Numeral id (tr_...). Returns the transaction with its line items, currencies, and metadata. Numeral: GET /tax/transactions/{tr
- `numeral_list_products`: 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) 
- `numeral_list_transaction_refunds`: List all refunds recorded against a transaction. Returns {refunds:[...]}. Numeral: GET /tax/transactions/{transaction_id}/refunds.
- `numeral_ping`: Health check — verifies the API key works and reports the environment (test/prod), api_version, and server timestamp. Numeral: GET /tax/ping.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.