Alpaca Trading API integration for Model Context Protocol (MCP)
Nothing to run from here
Numeral is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
93/100
tool-list score
11
tools declared
remote
at its publisher
—
calls last 7d
What it does
Calculate sales tax & VAT, record transactions and refunds, manage products and customers.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http numeral-mcp https://numeral.usefulapi.io/mcp
# 2 — ask your agent for something these tools do
# numeral_ping, numeral_calculate_tax, numeral_get_transaction and 8 more
Numeral costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
USAll 334 servers
usefulapi334 servers
24 categories
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http numeral-mcp https://numeral.usefulapi.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
11 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Health check — verifies the API key works and reports the environment (test/prod), api_version, and server timestamp. Numeral: GET /tax/ping.
No parameter schema on file.
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: P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| customer | object | yes | Customer details — address is required. |
| order_details | object | yes | Order details. |
| origin_address | object | no | The address a product ships from. Optional on 2024-09-01; required on API version 2025-05-12+. |
| metadata | object | no | Arbitrary string key/value metadata. |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction_id | string | yes | The Numeral transaction id (tr_...). |
List all refunds recorded against a transaction. Returns {refunds:[...]}. Numeral: GET /tax/transactions/{transaction_id}/refunds.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction_id | string | yes | The Numeral transaction id (tr_...). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| cursor | string | no | Pagination cursor — pass the last_product_id from the previous page. |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| reference_product_id | string | yes | Your product id (the reference_product_id used when the product was created). |
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}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| customer_id | string | yes | The customer id — a Numeral id (cus_...) by default, or your reference id when id_type="reference". |
| id_type | string | no | Which id space customer_id is in (default: numeral). |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| calculation_id | string | yes | The calculation id returned by numeral_calculate_tax. |
| reference_order_id | string | yes | Your order id for this sale (used for record keeping / dedupe). |
| transaction_processed_at | number | no | Unix timestamp (SECONDS) the sale was processed. Defaults to now if omitted. |
| metadata | object | no | Arbitrary string key/value metadata. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction_id | string | yes | The transaction id (tr_...) to refund. |
| type | string | yes | "full" refunds the whole transaction; "partial" requires line_items. |
| refund_processed_at | number | no | Unix timestamp (SECONDS) the refund was made. Defaults to now if omitted. |
| line_items | array | no | Required for type="partial": the line items to refund. |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| reference_product_id | string | yes | Your product id (used to reference this product in calculations). |
| reference_product_name | string | yes | Human-readable product name. |
| product_category | string | yes | A tax category from Numeral's taxonomy, e.g. "GENERAL_MERCHANDISE", "SAAS_GENERAL". |
CREATES a customer record — this WRITES to your Numeral customer list (used for order tracking and tax exemptions). Numeral: POST /tax/customers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| string | yes | Customer email (required). | |
| name | string | no | Customer name. |
| is_tax_exempt | boolean | no | Whether this customer is tax exempt. |
| reference_customer_id | string | no | Your own id for this customer (for reference-based lookups). |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Numeral or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
ATool-list grade · score 93 / 100
Release 1.11.1 · scanned 20 Oct 2026
Graded from the tools this server lists, not from its source code.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
Threat score100
Client score93
Findings0 threat · 0 capability
Capabilitymoderate
Coveragemanifest
Verificationnot in this report
Surface digestfeaae181b92d9c5d087b41713e91439210afd6d1a9b4a05128ac6f237374156d
Score vectorthreat 100 → client 93
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
Tool surfaceread
Implementation sourcenot available
Package metadatanot available
Live transportnot available
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| numeral_ping | no tags | |
| numeral_calculate_tax | no tags | |
| numeral_get_transaction | no tags | |
| numeral_list_transaction_refunds | no tags | |
| numeral_list_products | no tags | |
| numeral_get_product | no tags | |
| numeral_get_customer | no tags | |
| numeral_create_transaction | state-write | state-write: declares destructiveHint: true |
| numeral_create_refund | state-write | state-write: declares destructiveHint: true |
| numeral_create_product | state-write | state-write: declares destructiveHint: true |
| numeral_create_customer | state-write | state-write: declares destructiveHint: true |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
Integrityfirst-seen
Surface digestfeaae181b92d9c5d
Scanned2026-10-20
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.11.1.
1.11.1
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Numeral can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.