MCP server

Numeral MCP by usefulapi

io.usefulapi/numeral

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

11

Token cost

About 3,052 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

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

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"numeral":{"type":"http","url":"https://numeral.usefulapi.io/mcp"}}}

Antigravity

agy mcp add numeral https://numeral.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"numeral","server_url":"https://numeral.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"numeral","server_url":"https://numeral.usefulapi.io/mcp"}

Tools

• numeral_calculate_tax ~1166 tokens
  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 refere
• numeral_create_customer ~187 tokens
  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 ~216 tokens
  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 Moves money · ~397 tokens
  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 ~274 tokens
  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 ~200 tokens
  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 ~142 tokens
  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 ~128 tokens
  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 ~142 tokens
  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 ~118 tokens
  List all refunds recorded against a transaction. Returns {refunds:[...]}. Numeral: GET /tax/transactions/{transaction_id}/refunds.
• numeral_ping ~82 tokens
  Health check — verifies the API key works and reports the environment (test/prod), api_version, and server timestamp. Numeral: GET /tax/ping.

Browse

• Website monitoring
• Email

Related MCP servers

• Quaderno MCP by usefulapi
  MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
• AgendaPro MCP by usefulapi
  Read AgendaPro bookings, slots, clients, services and sales; create, update and cancel bookings.
• Paperform MCP by usefulapi
  Read Paperform forms, submissions, products and coupons, Papersign documents, and manage coupons.
• Hotmart
  Hotmart digital-products platform, sales (history, summary, commissions), subscriptions (list, cance
• GivingFuel MCP by usefulapi
  Read GivingFuel forms, donations, transactions, recurring gifts and donors; manage coupons.
• Buildium MCP by usefulapi
  Read Buildium properties, units, leases, tenants, balances and bills; manage work orders.
• Braintree MCP by usefulapi
  Search Braintree transactions, customers and payment methods, and refund or void charges.
• ChargeOver MCP by usefulapi
  Read ChargeOver customers, invoices, transactions, subscriptions, reports; create customers, quotes.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/numeral.svg)](https://aptlynx.net/servers/io.usefulapi/numeral)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents