INDIVIDUAL MCP TOOL

numeral_create_refund

RECORDS a refund against a transaction — this WRITES a live tax/compliance record (adjusts tax owed).

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://numeral.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for numeral_create_refund and invoke it with your own arguments.

{}

Potential side effects detected · medium confidence · heuristic, not a guarantee.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

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

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: numeral-mcp
Remote MCP URL: https://numeral.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "numeral-mcp",
  "transport": "streamable-http",
  "url": "https://numeral.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

numeral_ping — Health check — verifies the API key works and reports the environment (test/prod), api_version, and server timestamp.
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).
numeral_get_transaction — Get a recorded transaction by its Numeral id (tr_.
numeral_list_transaction_refunds — List all refunds recorded against a transaction.
numeral_list_products — List your Numeral products (up to 50 per page), each with its reference id, name, and product_category.
numeral_get_product — Get a single product by its reference_product_id (your id).
numeral_get_customer — Get a customer by id.
numeral_create_transaction — RECORDS a completed sale as a transaction — this WRITES a live tax/compliance record used for filings.