Numeral MCP Server

by usefulapi Your server? Claim it

answering

Numeral is answering right now. Last checked 15 min ago. It exposes 11 tools. Last commit 1 Sep 2026.

Calculate sales tax & VAT, record transactions and refunds, manage products and customers.

Uptime history 47 days of history · worst day 11%

47 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

170 ms

Response time

average over 24h

Stars

last commit 1 Sep 2026

Nothing serious here today

Today is the operative word: we check Numeral every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 15 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "numeral": {
      "url": "https://numeral.usefulapi.io/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.numeral]
url = "https://numeral.usefulapi.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "numeral": {
      "url": "https://numeral.usefulapi.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "numeral": {
      "url": "https://numeral.usefulapi.io/mcp"
    }
  }
}

Available tools 11

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

numeral

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 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.

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/products.

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="partial" with line_items (each keyed by reference_product_id) for a partial refund. Numeral: POST /tax/refunds.

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_tax and your `reference_order_id`. Numeral: POST /tax/transactions.

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 name, email, and tax-exempt status. Numeral: GET /tax/customers/{customer_id}.

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_product_id}.

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/{transaction_id}.

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) to paginate; has_more indicates more pages. Numeral: GET /tax/products.

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.

Endpoints

URL	Transport	State	Latency	Checked
https://numeral.usefulapi.io/mcp	streamable-http	answering	62 ms	15 min ago

Alternatives to Numeral

same job, measured the same way

Braintree

by usefulapi

Search Braintree transactions, customers and payment methods, and refund or void charges.

7 tools answering

Recur

by recur

Subscription payment platform for Taiwan — manage products, customers, and billing

answering

Shopify Admin

by mcparmory

Manage products, orders, customers, inventory, and store configuration

268 installs/wk local only

Cakto

by mcp-dir

Read your Cakto sales: orders, revenue analytics, subscriptions, churn, customers and products.

27 tools answering

Foxyio

by usefulapi

Read Foxy transactions, subscriptions, customers, carts and coupons; update customers and subs.

14 tools answering

Swell

by usefulapi

Manage your Swell headless-commerce store — products, orders, customers, and subscriptions.

16 tools answering

Shopware MCP

by bnymndev

Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.

818 installs/wk local only

Jumpseller

by jumpseller

Manage your Jumpseller store with AI. Products, orders, customers, and more.

answering

Numeral — questions

Answers built from our own checks of this server.

What can Numeral do?

It exposes 11 tools, read directly from the server on our last check. Among them: numeral_calculate_tax, numeral_create_customer, numeral_create_product, numeral_create_refund, numeral_create_transaction, numeral_get_customer and 5 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Numeral working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 170 ms. The bar chart above shows every period we have measured.

How do I connect Numeral?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Numeral need an API key?

No. Numeral completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 11 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Numeral?

It answers our handshake in 170 ms on average, which is faster than 72% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Numeral open source?

Yes — it is published under the MIT licence, written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.