io.usefulapi/numeral

up checked 2026-11-11T04:39:20.052Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Numeral MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Lets agents calculate sales tax and VAT, record sales and refunds, and manage products and customers for tax compliance.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add numeral --url https://numeral.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (11 tools)

Publisher-provided text

• numeral_ping Health check — verifies the API key works and reports the environment (test/prod), api_version, and server timestamp. Numeral: GET /tax/ping.
• 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_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_transaction_refunds List all refunds recorded against a transaction. Returns {refunds:[...]}. Numeral: GET /tax/transactions/{transaction_id}/refunds.
• 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_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_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_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_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_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_customer CREATES a customer record — this WRITES to your Numeral customer list (used for order tracking and tax exemptions). Numeral: POST /tax/customers.

Details

• Version: 1.37.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 407 ms
• First indexed: 2026-11-01T10:05:31.393Z
• Last seen in registry: 2026-11-11T00:17:30.488Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/numeral/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/numeral.svg)](https://lookupd.com/servers/io.usefulapi/numeral)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp