{ "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-10-08", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.4", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run" }, "tool": { "slug": "numeral", "name": "Numeral", "vendor": "Numeral Two, Inc.", "vendorUrl": "https://www.numeral.com", "kind": "http-api", "category": "tax", "summary": "Numeral is a hosted sales tax and VAT compliance service from Numeral Two, Inc. Its REST API calculates tax, records transactions and refunds, and manages exempt customers, and Numeral registers and files. A remote MCP server reads the account.", "url": "https://www.anchorterminal.com/tools/numeral", "markdownUrl": "https://www.anchorterminal.com/tools/numeral.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/numeral.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/numeral.json", "repo": "https://github.com/NumeralHQ/numeral-tax-go", "license": "Proprietary service under Numeral's terms of service. The Go, Python and Node SDKs are Apache-2.0", "transports": [ "http", "streamable-http" ], "remoteUrl": "https://api.numeralhq.com", "packages": [ { "registry": "go", "name": "github.com/NumeralHQ/numeral-tax-go" }, { "registry": "pypi", "name": "numeral-tax" }, { "registry": "npm", "name": "numeral-tax" } ], "auth": "api-key", "authNotes": "The API and the MCP server take a secret API key as a Bearer token, `sk_test_` for the sandbox or `sk_prod_` for live data. Keys are created and revoked in the dashboard at dashboard.numeralhq.com under Developers. No scopes, expiry or OAuth flow were found, and publishable keys are rejected by the MCP server. Dashboard access starts with the get-started form or a demo, and the product page says to book a demo before generating test keys. MCP write tools are enabled per account on request.", "pricing": "paid", "pricingNotes": "Professional is $75 per filing and $150 per state registration, month to month. The tax engine and API are listed under Enterprise at a custom price. Monitoring (nexus study and alerts) is free. Test keys record transactions with no charges or remittance, but no self-serve signup was found and whether a free account can create keys isn't stated (https://www.numeral.com/pricing, checked 2026-10-08).", "priceSummary": "$75 / tx", "where": "hosted", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the API docs, the OpenAPI spec or the pricing page (checked 2026-10-08).", "endpoints": [] }, "toolCount": 14, "popularity": { "githubStars": 0, "npmWeekly": 9, "pypiWeekly": 19, "asOf": "2026-10-08" }, "docsUrl": "https://docs.numeral.com", "llmsTxt": "https://docs.numeral.com/llms.txt", "openapi": "https://docs.numeral.com/api-reference/v2026-03-01/openapi.json", "capabilities": [ "tax.calculate", "tax.transactions", "tax.exemptions", "tax.filing" ], "tags": [ "hosted", "paid", "closed-source", "api-key", "mcp", "openapi", "llms-txt", "sandbox", "sales-led", "go", "python", "typescript" ], "lastRelease": "2026-09-15", "graded": true, "anchor": { "graded": true, "score": 49.3, "grade": "D", "agentReady": false, "rank": 611, "ranked": true, "rankOf": 722, "categoryRank": 10, "methodology": "0.4", "run": "2026-10-01", "scores": { "ergonomics": 71, "maintenance": 60, "payments": 10, "reliability": 25, "schema": 87, "security": 47, "transparency": 45 }, "pending": [ "performance", "tasks" ], "breakdown": [ { "key": "reliability", "name": "Reliability", "weight": 16, "effectiveWeight": 20, "score": 25, "points": 5, "reason": "Graded on the REST API with the hosted lines, with the MCP server noted where it differs. No status page was found on numeral.com, the docs or the help centre, and `status.numeral.com` and `status.numeralhq.com` did not answer (0). With no page there is no readable incident history (5). The docs name 429 responses for the API and the MCP server but give no number. The product page says rate limits can be removed on request, and the MCP docs describe a sliding window per account (0). The best practices guide advises exponential backoff on 429 and one retry on 500 or 503. No Retry-After header is documented, and there are no idempotency keys, though the docs give a duplicate-recovery pattern on `reference_order_id` (10). No uptime SLA found. The filing guarantee covers late returns, not availability (0). The API has four dated versions and no beta label, and the MCP docs carry none (10)." }, { "key": "performance", "name": "Performance", "weight": 10, "effectiveWeight": 0, "pending": true, "points": 0, "reason": "Pending. Latency is measured per call by our probes, which haven't run yet, so this run doesn't score it. Its weight is shared across the assessed categories until the first probe window closes." }, { "key": "schema", "name": "Schema \u0026 documentation", "weight": 13, "effectiveWeight": 16.25, "score": 87, "points": 14.14, "reason": "OpenAPI 3.0.1 at `docs.numeral.com/api-reference/v2026-03-01/openapi.json` with 32 operations and 74 schemas. An older unversioned spec with 15 operations is the one llms.txt links (25). `docs.numeral.com/llms.txt` indexes every page and each page is served as Markdown (10). Endpoint pages state purpose, the MCP overview says when to use MCP and when REST, and the AI help page publishes skills that list integration mistakes. We couldn't read the live MCP tool definitions without a key (16). 57 enums and 35 required lists, with 6 numeric bounds and 2 length limits (11). 235 examples in the spec and an error reference listing each `type`. The 2026-03-01 spec declares no 429 response (13). Versions are dates sent in `X-API-Version`, and the changelog covers each version with migration notes. Additions made after 1 March 2026 carry no date (12)." }, { "key": "ergonomics", "name": "Agent ergonomics", "weight": 13, "effectiveWeight": 16.25, "score": 71, "points": 11.54, "reason": "List endpoints take `cursor`, and merchants and certificates take `limit` up to 100. No field selection. The MCP server documents 14 tools, list tools return summaries, and `get_sales_summary` aggregates in one call (16). Cursor paging throughout. Certificates filter by status, customer, jurisdiction and dates, while product and customer lists take only a cursor (16). Errors are flat JSON with `code`, `type` and `message` and a documented list of types. MCP tool errors return a stable `error_code` with a corrective message (19). No idempotency keys, and the docs say an `Idempotency-Key` header is silently ignored. Commits are made safe by handling `REFERENCE_ORDER_ID_ALREADY_EXISTS`, and cancelling a certificate request is idempotent. MCP annotations unread (11). A calculation needs an address or IP, line items, `origin_address` and `automatic_tax`. SDKs exist for Go, Python and Node, all below 1.0 and two marked alpha (9)." }, { "key": "security", "name": "Security \u0026 auth", "weight": 14, "effectiveWeight": 17.5, "score": 47, "points": 8.23, "reason": "Secret API keys as Bearer tokens, `sk_test_` or `sk_prod_`, created and revoked in the dashboard, with revocation immediate per the MCP docs. No scopes, expiry or OAuth found (20). Test keys reach sandbox data only. The MCP server is read-only by default and its four write tools stay unregistered until Numeral enables them for an account. The REST API has no read-only key and no confirmation step (10). Responses carry merchant, customer and product names written by others, with no injection guidance found. The docs do state that no tool accepts an account identifier (3). The dashboard's Logs tab shows each request and response (8). A trust centre at security.numeral.com runs on Oneleet and is drawn by script, so we couldn't read it. No security.txt, bug bounty or disclosure policy found. The DPA lists security measures (6)." }, { "key": "payments", "name": "Payments \u0026 pricing", "weight": 10, "effectiveWeight": 12.5, "score": 10, "points": 1.25, "reason": "No x402, MPP or L402 (0). The pricing page gives $75 per filing and $150 per registration on Professional. The tax engine and API sit under Enterprise at a custom price, so the surface an agent calls has no public price (5). The Monitoring plan is free and test keys cost nothing, but the get-started page is a qualification form that ends in a demo booking, and whether a free account can create API keys isn't stated (5). Keys are created by a person in the dashboard (0)." }, { "key": "tasks", "name": "Task success", "weight": 10, "effectiveWeight": 0, "pending": true, "points": 0, "reason": "Pending. Task success needs the category task suites run through each tool, which haven't run yet, so this run doesn't score it. Its weight is shared across the assessed categories until then. A data provider's data-quality score is published on its listing now and becomes half of this category when it's scored." }, { "key": "maintenance", "name": "Maintenance \u0026 community", "weight": 7, "effectiveWeight": 8.75, "score": 60, "points": 5.25, "reason": "Closed service. The 2026-03-01 spec was last modified on 15 September 2026 and the docs were rebuilt on 8 October 2026 per their Last-Modified headers (30). The changelog has no dated entry since 1 March 2026. Dated activity in the last 90 days is the spec change, the Go SDK v0.1.0 on 27 August and the npm package on 18 August 2026 (10). A public changelog by version, a help centre and support by email. No public issue tracker in use (7). Go, Python and Node SDKs generated by Stainless, none at 1.0, and the Python package dates from 18 December 2025. Numeral's MCP server isn't in the official registry, where the only entry for the name is a third party's (8). The Go SDK has CI and a changelog (5)." }, { "key": "transparency", "name": "Transparency \u0026 trust", "weight": 7, "effectiveWeight": 8.75, "score": 45, "points": 3.94, "note": "editorial 36, provenance 53", "reason": "Closed service under terms last updated 10 June 2025 that name Numeral Two, Inc. and California law. The SDKs are Apache-2.0 (15). The terms let Numeral use customer content to improve the services and other Numeral offerings and say it has no obligation to store it. The DPA of 2 January 2024 limits use to the customer's purposes and promises deletion or return at the end of service. The privacy policy of 11 May 2026 excludes platform data. No retention period or statement on AI training was found (12). No deprecation policy found. Four API versions stay documented with no end dates (4). The DPA says the subprocessor list is available by email and promises 30 days' notice of changes. Hosting location for platform data isn't stated (5)." } ], "assessment": { "date": "2026-10-08", "basis": "public evidence", "confidence": "medium", "notes": { "ergonomics": "List endpoints take `cursor`, and merchants and certificates take `limit` up to 100. No field selection. The MCP server documents 14 tools, list tools return summaries, and `get_sales_summary` aggregates in one call (16). Cursor paging throughout. Certificates filter by status, customer, jurisdiction and dates, while product and customer lists take only a cursor (16). Errors are flat JSON with `code`, `type` and `message` and a documented list of types. MCP tool errors return a stable `error_code` with a corrective message (19). No idempotency keys, and the docs say an `Idempotency-Key` header is silently ignored. Commits are made safe by handling `REFERENCE_ORDER_ID_ALREADY_EXISTS`, and cancelling a certificate request is idempotent. MCP annotations unread (11). A calculation needs an address or IP, line items, `origin_address` and `automatic_tax`. SDKs exist for Go, Python and Node, all below 1.0 and two marked alpha (9).", "maintenance": "Closed service. The 2026-03-01 spec was last modified on 15 September 2026 and the docs were rebuilt on 8 October 2026 per their Last-Modified headers (30). The changelog has no dated entry since 1 March 2026. Dated activity in the last 90 days is the spec change, the Go SDK v0.1.0 on 27 August and the npm package on 18 August 2026 (10). A public changelog by version, a help centre and support by email. No public issue tracker in use (7). Go, Python and Node SDKs generated by Stainless, none at 1.0, and the Python package dates from 18 December 2025. Numeral's MCP server isn't in the official registry, where the only entry for the name is a third party's (8). The Go SDK has CI and a changelog (5).", "payments": "No x402, MPP or L402 (0). The pricing page gives $75 per filing and $150 per registration on Professional. The tax engine and API sit under Enterprise at a custom price, so the surface an agent calls has no public price (5). The Monitoring plan is free and test keys cost nothing, but the get-started page is a qualification form that ends in a demo booking, and whether a free account can create API keys isn't stated (5). Keys are created by a person in the dashboard (0).", "reliability": "Graded on the REST API with the hosted lines, with the MCP server noted where it differs. No status page was found on numeral.com, the docs or the help centre, and `status.numeral.com` and `status.numeralhq.com` did not answer (0). With no page there is no readable incident history (5). The docs name 429 responses for the API and the MCP server but give no number. The product page says rate limits can be removed on request, and the MCP docs describe a sliding window per account (0). The best practices guide advises exponential backoff on 429 and one retry on 500 or 503. No Retry-After header is documented, and there are no idempotency keys, though the docs give a duplicate-recovery pattern on `reference_order_id` (10). No uptime SLA found. The filing guarantee covers late returns, not availability (0). The API has four dated versions and no beta label, and the MCP docs carry none (10).", "schema": "OpenAPI 3.0.1 at `docs.numeral.com/api-reference/v2026-03-01/openapi.json` with 32 operations and 74 schemas. An older unversioned spec with 15 operations is the one llms.txt links (25). `docs.numeral.com/llms.txt` indexes every page and each page is served as Markdown (10). Endpoint pages state purpose, the MCP overview says when to use MCP and when REST, and the AI help page publishes skills that list integration mistakes. We couldn't read the live MCP tool definitions without a key (16). 57 enums and 35 required lists, with 6 numeric bounds and 2 length limits (11). 235 examples in the spec and an error reference listing each `type`. The 2026-03-01 spec declares no 429 response (13). Versions are dates sent in `X-API-Version`, and the changelog covers each version with migration notes. Additions made after 1 March 2026 carry no date (12).", "security": "Secret API keys as Bearer tokens, `sk_test_` or `sk_prod_`, created and revoked in the dashboard, with revocation immediate per the MCP docs. No scopes, expiry or OAuth found (20). Test keys reach sandbox data only. The MCP server is read-only by default and its four write tools stay unregistered until Numeral enables them for an account. The REST API has no read-only key and no confirmation step (10). Responses carry merchant, customer and product names written by others, with no injection guidance found. The docs do state that no tool accepts an account identifier (3). The dashboard's Logs tab shows each request and response (8). A trust centre at security.numeral.com runs on Oneleet and is drawn by script, so we couldn't read it. No security.txt, bug bounty or disclosure policy found. The DPA lists security measures (6).", "transparency": "Closed service under terms last updated 10 June 2025 that name Numeral Two, Inc. and California law. The SDKs are Apache-2.0 (15). The terms let Numeral use customer content to improve the services and other Numeral offerings and say it has no obligation to store it. The DPA of 2 January 2024 limits use to the customer's purposes and promises deletion or return at the end of service. The privacy policy of 11 May 2026 excludes platform data. No retention period or statement on AI training was found (12). No deprecation policy found. Four API versions stay documented with no end dates (4). The DPA says the subprocessor list is available by email and promises 30 days' notice of changes. Hosting location for platform data isn't stated (5)." }, "sources": [ { "what": "docs index, llms.txt", "url": "https://docs.numeral.com/llms.txt", "seen": "2026-10-08" }, { "what": "docs introduction", "url": "https://docs.numeral.com/introduction.md", "seen": "2026-10-08" }, { "what": "quickstart", "url": "https://docs.numeral.com/essentials/quickstart/quickstart.md", "seen": "2026-10-08" }, { "what": "API keys", "url": "https://docs.numeral.com/essentials/api-keys.md", "seen": "2026-10-08" }, { "what": "API reference introduction, version 2026-03-01", "url": "https://docs.numeral.com/api-reference/v2026-03-01/introduction.md", "seen": "2026-10-08" }, { "what": "OpenAPI spec, version 2026-03-01", "url": "https://docs.numeral.com/api-reference/v2026-03-01/openapi.json", "seen": "2026-10-08" }, { "what": "OpenAPI spec linked from llms.txt", "url": "https://docs.numeral.com/api-reference/openapi.json", "seen": "2026-10-08" }, { "what": "API changelog", "url": "https://docs.numeral.com/api-reference/v2026-03-01/changelog.md", "seen": "2026-10-08" }, { "what": "error codes", "url": "https://docs.numeral.com/api-reference/v2026-03-01/error-codes.md", "seen": "2026-10-08" }, { "what": "create calculations endpoint", "url": "https://docs.numeral.com/api-reference/v2026-03-01/endpoint/calculations.md", "seen": "2026-10-08" }, { "what": "best practices, error handling", "url": "https://docs.numeral.com/essentials/integration-guides/best-practices.md", "seen": "2026-10-08" }, { "what": "AI help, skills and idempotency guidance", "url": "https://docs.numeral.com/ai-help/overview.md", "seen": "2026-10-08" }, { "what": "MCP overview", "url": "https://docs.numeral.com/mcp/overview.md", "seen": "2026-10-08" }, { "what": "MCP quickstart", "url": "https://docs.numeral.com/mcp/quickstart.md", "seen": "2026-10-08" }, { "what": "MCP tool reference", "url": "https://docs.numeral.com/mcp/tools.md", "seen": "2026-10-08" }, { "what": "MCP authentication and limits", "url": "https://docs.numeral.com/mcp/authentication.md", "seen": "2026-10-08" }, { "what": "MCP health check", "url": "https://mcp.numeralhq.com/ping", "seen": "2026-10-08" }, { "what": "pricing", "url": "https://www.numeral.com/pricing", "seen": "2026-10-08" }, { "what": "tax engine and API product page", "url": "https://www.numeral.com/product/api", "seen": "2026-10-08" }, { "what": "get-started form", "url": "https://www.numeral.com/get-started", "seen": "2026-10-08" }, { "what": "terms of service", "url": "https://www.numeral.com/legal/terms-of-service", "seen": "2026-10-08" }, { "what": "data processing agreement", "url": "https://www.numeral.com/legal/dpa", "seen": "2026-10-08" }, { "what": "privacy policy", "url": "https://www.numeral.com/legal/privacy-policy", "seen": "2026-10-08" }, { "what": "guarantee", "url": "https://www.numeral.com/legal/guarantee", "seen": "2026-10-08" }, { "what": "trust centre, script-drawn and unread", "url": "https://security.numeral.com/", "seen": "2026-10-08" }, { "what": "marketing llms.txt", "url": "https://www.numeral.com/llms.txt", "seen": "2026-10-08" }, { "what": "security.txt, 404", "url": "https://www.numeral.com/.well-known/security.txt", "seen": "2026-10-08" }, { "what": "GitHub organisation repositories", "url": "https://github.com/NumeralHQ", "seen": "2026-10-08" }, { "what": "Go SDK", "url": "https://github.com/NumeralHQ/numeral-tax-go", "seen": "2026-10-08" }, { "what": "Python package", "url": "https://pypi.org/project/numeral-tax/", "seen": "2026-10-08" }, { "what": "npm package", "url": "https://www.npmjs.com/package/numeral-tax", "seen": "2026-10-08" }, { "what": "official MCP registry search", "url": "https://registry.modelcontextprotocol.io/v0.1/servers?search=numeral", "seen": "2026-10-08" }, { "what": "domain registration, numeral.com", "url": "https://rdap.verisign.com/com/v1/domain/numeral.com", "seen": "2026-10-08" }, { "what": "domain registration, numeralhq.com", "url": "https://rdap.verisign.com/com/v1/domain/numeralhq.com", "seen": "2026-10-08" } ], "openQuestions": [ "unchecked: the trust centre at security.numeral.com, a Oneleet page drawn by script. Certifications, penetration tests and any disclosure policy listed there were not read. Numeral's llms.txt says it holds SOC 2 information", "unchecked: the live MCP tool definitions, input schemas and annotations, which need an API key. The count of 14 comes from the tool reference page", "unchecked: the dashboard, including whether a free Monitoring account can create test API keys without a demo", "Whether a status page exists. None is linked from the site, docs or help centre, and two guessed hostnames did not answer", "The numeric rate limits for the API and the MCP server. Neither is published", "The product page names Java, Python and Ruby SDKs. We found Go, Python and Node packages and no Java or Ruby one", "The price of API access. The pricing page lists the tax engine and API under Enterprise as Custom", "The privacy policy excludes platform data, so `provenance.privacy` points at the DPA, the published document that governs personal data in the product", "lastRelease is the Last-Modified date of the 2026-03-01 OpenAPI spec, since the changelog carries no dated entry after 1 March 2026" ] }, "negative": 0, "verdict": "Docs are written for agents, with a public OpenAPI spec for 32 operations, Markdown pages, llms.txt and a remote MCP server whose 14 tools are read-only by default. No status page, numeric rate limit or SLA was found, the API ignores idempotency keys, and API access is sold on a custom plan after a demo.", "bestFor": "An agent working for a seller or platform that has a Numeral account and needs tax at checkout, committed transactions for filing, and read access to nexus, registrations and filings through MCP.", "strengths": [ "Public OpenAPI 3.0.1 spec for version 2026-03-01 with 32 operations, 74 schemas and 57 enums, plus llms.txt and a Markdown copy of every docs page", "Remote MCP server at `https://mcp.numeralhq.com/mcp` documents 14 read-only tools. Four write tools are off by default and absent from `tools/list` until enabled", "Date-versioned API selected with the `X-API-Version` header, with a changelog and migration notes for each of four versions", "Errors are flat JSON with `code`, `type` and `message`, and the docs list every `type`. MCP tool errors carry a stable `error_code`", "`sk_test_` keys read and write sandbox data only, and the docs say revoking a key takes effect immediately" ], "weaknesses": [ "No status page, uptime SLA or numeric rate limit was found. The product page says rate limits can be removed on request", "The API ignores an `Idempotency-Key` header. A retried commit is safe only if the client handles `REFERENCE_ORDER_ID_ALREADY_EXISTS`", "Secret keys carry no scopes, and the MCP server has no OAuth flow. One key reads all of the account's tax data", "API access is listed under the Enterprise plan at a custom price, and the product page says to book a demo first", "SDKs are early. Go is v0.1.0, `numeral-tax` on PyPI is 0.1.0a1 from December 2025 and on npm is 0.1.0-alpha.2" ], "agentNotes": [ "Send `X-API-Version: 2026-03-01` on every call to `https://api.numeralhq.com`. Merchant, platform and certificate endpoints reject requests without it", "Commit with a stable `reference_order_id`. On `REFERENCE_ORDER_ID_ALREADY_EXISTS` look up the existing transaction, because `Idempotency-Key` is ignored", "Commit before the calculation's `expires_at`. If it has expired, calculate again and commit the new `calculation_id` with the original `reference_order_id`", "Send `amount` as the line total in minor units to `/tax/calculations` and as the per-unit price to `/tax/platform/calculations`", "Start with an `sk_test_` key. Certificate endpoints and MCP certificate tools are live only and answer `TESTMODE_NOT_SUPPORTED` or `live_mode_required`" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "D", "methodology": "0.4", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 49.3 } ], "editorialScores": { "ergonomics": 71, "maintenance": 60, "payments": 10, "reliability": 25, "schema": 87, "security": 47, "transparency": 36 }, "provenanceScore": 53 }, "connect": { "install": "go get -u 'github.com/NumeralHQ/numeral-tax-go@v0.1.0'", "http": "curl --request POST \\\n --url https://api.numeralhq.com/tax/calculations \\\n --header 'Authorization: Bearer \u003ctoken\u003e' \\\n --header 'Content-Type: application/json' \\\n --header 'X-API-Version: 2026-03-01' \\\n --data '{ ... }'", "claudeCode": "claude mcp add --transport http numeral https://mcp.numeralhq.com/mcp \\\n --header \"Authorization: Bearer sk_test_...\"", "config": { "mcpServers": { "numeral": { "headers": { "Authorization": "Bearer sk_test_..." }, "type": "http", "url": "https://mcp.numeralhq.com/mcp" } } } }, "letme": { "capability": "https://letme.dev/tax.calculate", "tool": "https://letme.dev/numeral" }, "notable": [ "The 2026-03-01 spec has 32 operations under `/tax` for calculations, transactions, refunds, products, customers, merchants, platform calculations and exemption certificates (https://docs.numeral.com/api-reference/v2026-03-01/openapi.json)", "The MCP server at https://mcp.numeralhq.com/mcp is stateless Streamable HTTP with 14 documented read-only tools for merchants, nexus, registrations, filings, transactions, sales, products and certificates (https://docs.numeral.com/mcp/tools)", "Four MCP write tools (`approve_filing`, `reject_filing`, `set_product_tax_category`, `submit_exemption_certificate`) are gated per account and don't appear in `tools/list` until enabled (https://docs.numeral.com/mcp/tools)", "The docs say Numeral does not support an `Idempotency-Key` header and silently ignores one. Safe retries rest on `reference_order_id` and the `REFERENCE_ORDER_ID_ALREADY_EXISTS` error (https://docs.numeral.com/ai-help/overview)", "Version 2026-03-01 added tax calculation from a customer's IP address with four resolution modes (strict, zero, approximate, best_effort) (https://docs.numeral.com/api-reference/v2026-03-01/changelog)", "The terms let Numeral use customer content to improve the services and other Numeral offerings, and disclose it in aggregate or de-identified form (https://www.numeral.com/legal/terms-of-service, section 3)", "The only server named numeral in the official MCP registry is `io.usefulapi/numeral`, published by a third party and not by Numeral (https://registry.modelcontextprotocol.io/v0.1/servers?search=numeral)" ], "area": "domain-data", "details": [ { "label": "API", "value": "32 operations under https://api.numeralhq.com/tax in version 2026-03-01. OpenAPI 3.0.1 at https://docs.numeral.com/api-reference/v2026-03-01/openapi.json. Amounts are integers in minor units" }, { "label": "Versions", "value": "2024-09-01, 2025-05-12, 2026-01-01 and 2026-03-01, chosen with the `X-API-Version` header. Merchant, platform and certificate endpoints need 2026-01-01 or later" }, { "label": "Calculation", "value": "`POST /tax/calculations` returns tax per line item and jurisdiction with an `expires_at`. `POST /tax/transactions` commits a `calculation_id` under a `reference_order_id` for filing. The best practices guide gives 24 hours as the calculation lifetime" }, { "label": "MCP server", "value": "Remote, stateless Streamable HTTP at https://mcp.numeralhq.com/mcp, POST only. 14 documented read-only tools. Four write tools gated per account. Health check at `GET /ping`" }, { "label": "Credentials", "value": "Secret API key as a Bearer token for both surfaces, `sk_test_` or `sk_prod_`. No scopes or OAuth. Revocation takes effect immediately per the MCP docs" }, { "label": "Rate limits", "value": "Not published. 429 on the API and 429 with JSON-RPC code -32005 on MCP, metered separately and per account. The docs advise exponential backoff" }, { "label": "Errors", "value": "From 2026-01-01, flat JSON with `code`, `type` and `message`, such as `ZIP_STATE_MISMATCH`. MCP tool errors return `error_code` and `error_message` with `isError` set" }, { "label": "Paging", "value": "Cursor paging with `has_more`. `limit` defaults to 10 with a maximum of 100 on merchants and certificates, and to 25 with a maximum of 100 on MCP list tools" }, { "label": "Sandbox", "value": "Test keys keep merchant, transaction and product data apart from production, and nothing is filed. Certificate endpoints are live only" }, { "label": "Pricing", "value": "Monitoring free. Professional $75 per filing and $150 per registration. Enterprise, which lists the tax engine and API, is custom" }, { "label": "SDKs", "value": "Go `github.com/NumeralHQ/numeral-tax-go` v0.1.0 (27 August 2026), Python `numeral-tax` 0.1.0a1 (18 December 2025), Node `numeral-tax` 0.1.0-alpha.2 (18 August 2026), generated by Stainless, Apache-2.0" }, { "label": "Agent docs", "value": "llms.txt, Markdown pages, and Claude skills installed with `npx skills add https://docs.numeralhq.com`, which reference an optional `numeral-api-docs` MCP server for the documentation" }, { "label": "Coverage", "value": "Numeral says all US jurisdictions and 90+ countries (https://www.numeral.com/product/api)" }, { "label": "Status", "value": "No status page found" } ], "unitPrices": [ { "item": "Filed return, Professional", "unit": "tx", "usd": 75, "note": "Per return filed. API access is listed under Enterprise at a custom price" }, { "item": "State registration, Professional", "unit": "tx", "usd": 150, "note": "One-time fee per state" } ], "provenance": { "legalEntity": "Numeral Two, Inc.", "domain": "numeral.com", "domainRegistered": "1997-10-02", "endpointOnVendorDomain": false, "terms": "https://www.numeral.com/legal/terms-of-service", "privacy": "", "statusPage": "", "changelog": "https://docs.numeral.com/api-reference/v2026-03-01/changelog", "securityTxt": "none", "checked": "2026-10-08", "notes": [ "The terms of service (last updated 10 June 2025) name Numeral Two, Inc. d/b/a Numeral, 527 Howard St, San Francisco, and are governed by California law.", "The API answers at api.numeralhq.com and the MCP server at mcp.numeralhq.com, a second domain. Numeral's docs name both hosts, and the dashboard is at dashboard.numeralhq.com.", "The privacy policy at numeral.com/legal/privacy-policy (effective 11 May 2026) covers the websites and says it does not apply to data processed through the platform and APIs. The privacy link here is the Data Processing Agreement (last updated 2 January 2024), which governs that data.", "www.numeral.com/.well-known/security.txt returns 404, as do the same paths on www.numeralhq.com and api.numeralhq.com.", "No status page was found on the site, the docs or the help centre.", "The trust centre at security.numeral.com is a Oneleet page drawn by script, which we couldn't read.", "RDAP gives registration dates of 1997-10-02 for numeral.com and 2022-07-14 for numeralhq.com." ], "score": 53, "checks": [ { "check": "Legal entity named", "value": "Numeral Two, Inc.", "points": 20, "max": 20, "state": "ok" }, { "check": "Domain age", "value": "numeral.com, registered 1997-10-02 (29 years)", "points": 15, "max": 15, "state": "ok" }, { "check": "Endpoint on the vendor's domain", "value": "api.numeralhq.com is not on numeral.com", "points": 0, "max": 15, "state": "no" }, { "check": "Terms of service", "value": "read, states 5 of the 7 things a reader expects", "points": 8.3, "max": 10, "state": "part" }, { "check": "Privacy policy", "value": "not found", "points": 0, "max": 10, "state": "no" }, { "check": "Status page", "value": "not found", "points": 0, "max": 10, "state": "no" }, { "check": "Changelog", "value": "published", "points": 10, "max": 10, "state": "ok" }, { "check": "security.txt", "value": "not found", "points": 0, "max": 10, "state": "no" } ], "policies": [ { "kind": "terms", "url": "https://www.numeral.com/legal/terms-of-service", "state": "read", "readAt": "2026-10-08", "words": 10957, "points": 8.3, "max": 10, "expected": [ { "key": "terms.date", "label": "Gives the date it was last updated", "found": false }, { "key": "terms.law", "label": "Names the governing law or courts", "found": true, "quote": "THIS AGREEMENT and any action related thereto will be governed and interpreted by and under the laws of the State of CALIFORNIA, consistent with the Federal Arbitration Act, without giving effect to any principles that provide for the application of the law of another jurisdiction.", "says": "The law of the State of CALIFORNIA" }, { "key": "terms.liability", "label": "States a limit on its liability", "found": true, "quote": "IN NO EVENT WILL NUMERAL BE LIABLE FOR ANY LOSS, COST, LIABLITY OR DAMAGE INCURRED AS A RESULT OF YOUR RECEIPT OF OR PARTICIPATION IN THIRD-PARTY SERVICES." }, { "key": "terms.termination", "label": "Says how the agreement or account can be ended", "found": true, "quote": "Upon renewal of your Subscription, if we do not receive payment, (i) you shall pay all amounts due on your account upon demand and/or (ii) you agree that we may either terminate or suspend your Subscription and continue to attempt to charge your designated payment method until payment is received." }, { "key": "terms.changes", "label": "Says how changes to the terms are announced", "found": true, "quote": "The revised Agreement will become effective thirty (30) days after we post or send you notice of such changes.", "says": "Gives thirty days of notice before a change" }, { "key": "terms.use", "label": "Lists what users may not do", "found": true, "quote": "If you do not have such authority, or if you do not agree with this Agreement, you must not accept this Agreement and may not use the Services." }, { "key": "terms.sla", "label": "Refers to a service level or uptime commitment", "found": false } ], "toKnow": [ { "key": "terms.cutoff", "label": "Says access can be ended without notice or for any reason", "found": true, "quote": "Numeral may, with or without notice, terminate or suspend this Agreement (including the Services), at any time and for any reason, including if you have materially breached any provision of this Agreement, or if Numeral is required to do so by law" }, { "key": "terms.arbitration", "label": "Requires arbitration or waives class actions", "found": true, "quote": "It contains procedures for MANDATORY BINDING ARBITRATION AND A CLASS ACTION WAIVER." } ], "notes": [ { "date": "2026-10-08", "text": "Numeral may use customer content to improve its services and for development of its other products, during and after the agreement.", "quote": "Numeral will be free (during and after the term of this Agreement) to (i) use Your Content to improve and enhance the Services and for other development, diagnostic and corrective purposes in connection with the Services and other Numeral offerings" }, { "date": "2026-10-08", "text": "Numeral may use the customer's name, logo and trademarks in marketing unless the customer emails to decline.", "quote": "Numeral may identify you and use your name, logo, and trademarks on the Site and in marketing materials to identify you as a user of the Services." }, { "date": "2026-10-08", "text": "Numeral may permanently delete all customer content when the account is terminated.", "quote": "All of Your Content on the Services (if any) may be permanently deleted by Numeral upon any termination of your Numeral account in its sole discretion." } ] }, { "kind": "privacy", "url": "", "state": "none-found", "points": 0, "max": 10 } ] }, "pageJsonUrl": "https://www.anchorterminal.com/tools/numeral.json", "live": { "slug": "numeral", "probe": { "target": "https://api.numeralhq.com", "method": "get", "lastAt": "2026-10-08T21:12:16.935226704Z", "lastOk": true, "lastStatus": 200, "lastMs": 602, "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 606, "p95ms24h": 672, "samples24h": 21, "samples30d": 21, "days": [ { "date": "2026-10-08", "probes": 21, "ok": 21 } ] }, "updatedAt": "2026-10-08T21:12:16.935226704Z" } } }