{ "data": { "similar": [ { "grade": "B", "json": "https://www.anchorterminal.com/tools/avalara.json", "name": "Avalara AvaTax", "score": 68.8, "shared": [ "tax.calculate", "tax.transactions", "tax.exemptions", "tax.filing" ], "slug": "avalara" }, { "grade": "C", "json": "https://www.anchorterminal.com/tools/anrok.json", "name": "Anrok", "score": 61.6, "shared": [ "tax.calculate", "tax.transactions", "tax.exemptions", "tax.filing" ], "slug": "anrok" }, { "grade": "C", "json": "https://www.anchorterminal.com/tools/kintsugi.json", "name": "Kintsugi", "score": 60.7, "shared": [ "tax.calculate", "tax.transactions", "tax.filing", "tax.exemptions" ], "slug": "kintsugi" }, { "grade": "D", "json": "https://www.anchorterminal.com/tools/zamp.json", "name": "Zamp", "score": 49.5, "shared": [ "tax.calculate", "tax.transactions", "tax.filing", "tax.exemptions" ], "slug": "zamp" }, { "grade": "C", "json": "https://www.anchorterminal.com/tools/taxjar.json", "name": "TaxJar", "score": 57.6, "shared": [ "tax.calculate", "tax.transactions", "tax.exemptions" ], "slug": "taxjar" }, { "grade": "C", "json": "https://www.anchorterminal.com/tools/taxcloud.json", "name": "TaxCloud", "score": 57.4, "shared": [ "tax.calculate", "tax.transactions", "tax.exemptions" ], "slug": "taxcloud" } ], "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-09T02:43:02.275805876Z", "lastOk": true, "lastStatus": 200, "lastMs": 561, "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 596, "p95ms24h": 672, "samples24h": 79, "samples30d": 79, "days": [ { "date": "2026-10-08", "probes": 50, "ok": 50 }, { "date": "2026-10-09", "probes": 29, "ok": 29 } ] }, "updatedAt": "2026-10-09T02:43:02.275805876Z" } }, "verify": { "accepts": "a page on numeral.com or one of its subdomains, or the README of github.com/NumeralHQ/numeral-tax-go", "badgeUrl": "https://www.anchorterminal.com/badges/numeral.svg", "body": { "slug": "numeral", "url": "the page with the badge or the link" }, "docs": "https://www.anchorterminal.com/builders/#verify", "effect": "none, it never changes a grade, rank or review", "endpoint": "https://www.anchorterminal.com/api/v1/verify", "listingUrl": "https://www.anchorterminal.com/tools/numeral", "mcpTool": "verify_listing", "recheck": "weekly; two failed checks in a row and it lapses, a later pass restores it", "snippets": { "html": "\u003ca href=\"https://www.anchorterminal.com/tools/numeral\"\u003e\u003cimg src=\"https://www.anchorterminal.com/badges/numeral.svg\" alt=\"Numeral on Anchor Terminal\" height=\"20\"\u003e\u003c/a\u003e", "markdown": "[![Numeral on Anchor Terminal](https://www.anchorterminal.com/badges/numeral.svg)](https://www.anchorterminal.com/tools/numeral)", "link": "\u003ca href=\"https://www.anchorterminal.com/tools/numeral\"\u003eNumeral on Anchor Terminal\u003c/a\u003e" } } }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/tools/numeral", "json": "https://www.anchorterminal.com/tools/numeral.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/tools/numeral.md", "slim": "https://www.anchorterminal.com/tools/numeral.min.md" }, "markdown": "## Overview\n\n**Grade D · 49.3/100 · rank #611 of 722 · #10 in Tax calculation \u0026 compliance · not agent-ready · confidence medium**\n\n\n## Assessment\n\nDocs 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.\n\n## Facts\n\n| Field | Value |\n| --- | --- |\n| Vendor | Numeral Two, Inc. (https://www.numeral.com) |\n| Kind | HTTP API |\n| Category | Tax calculation \u0026 compliance (https://www.anchorterminal.com/categories/tax) |\n| Transport | HTTP, Streamable HTTP |\n| Endpoint | `https://api.numeralhq.com` |\n| Auth | API key · 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. |\n| Pricing | Paid ($75 / tx) · 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). |\n| x402 | No · No x402, MPP or L402 in the API docs, the OpenAPI spec or the pricing page (checked 2026-10-08). |\n| Licence | Proprietary service under Numeral's terms of service. The Go, Python and Node SDKs are Apache-2.0 |\n| Tools exposed | 14 |\n| Packages | go: `github.com/NumeralHQ/numeral-tax-go`; pypi: `numeral-tax`; npm: `numeral-tax` |\n| Source | https://github.com/NumeralHQ/numeral-tax-go |\n| Docs | https://docs.numeral.com |\n| llms.txt | https://docs.numeral.com/llms.txt |\n| Last release | 2026-09-15 |\n| GitHub stars | 0 (as of 2026-10-08) |\n| npm downloads / week | 9 |\n| PyPI downloads / week | 19 |\n| API | 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 |\n| Versions | 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 |\n| Calculation | `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 |\n| MCP server | 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` |\n| Credentials | 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 |\n| Rate limits | 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 |\n| Errors | 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 |\n| Paging | 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 |\n| Sandbox | Test keys keep merchant, transaction and product data apart from production, and nothing is filed. Certificate endpoints are live only |\n| Pricing | Monitoring free. Professional $75 per filing and $150 per registration. Enterprise, which lists the tax engine and API, is custom |\n| SDKs | 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 |\n| Agent docs | 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 |\n| Coverage | Numeral says all US jurisdictions and 90+ countries (https://www.numeral.com/product/api) |\n| Status | No status page found |\n| Capabilities | tax.calculate, tax.transactions, tax.exemptions, tax.filing |\n| Tags | hosted, paid, closed-source, api-key, mcp, openapi, llms-txt, sandbox, sales-led, go, python, typescript |\n| JSON | https://www.anchorterminal.com/api/v1/tools/numeral.json |\n\n## Score breakdown (methodology v0.4, October 2026 research run)\n\nAssessed 2026-10-08 from public evidence against the published checklist (https://www.anchorterminal.com/benchmark/#checklist). Confidence: medium. Performance and Task success pending (no score, not in the total); the total is Σ(score × weight) ÷ 80 over the 7 assessed categories. \"This run\" is each category's share of the 100 points.\n\n| Category | Weight | This run | Score (0–100) | Points |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% | 20 | 25 | 5.0 |\n| Performance | 10% | pending | pending | n/a |\n| Schema \u0026 documentation | 13% | 16.2 | 87 | 14.1 |\n| Agent ergonomics | 13% | 16.2 | 71 | 11.5 |\n| Security \u0026 auth | 14% | 17.5 | 47 | 8.2 |\n| Payments \u0026 pricing | 10% | 12.5 | 10 | 1.2 |\n| Task success | 10% | pending | pending | n/a |\n| Maintenance \u0026 community | 7% | 8.8 | 60 | 5.2 |\n| Transparency \u0026 trust (editorial 36, provenance 53) | 7% | 8.8 | 45 | 3.9 |\n| Negative events | up to −15 | up to −15 | none recorded | 0 |\n| **Total** | | | | **49.3 → D** |\n\n### Why each score\n\n- Reliability 25: 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).\n- Performance: 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.\n- Schema \u0026 documentation 87: 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).\n- Agent ergonomics 71: 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).\n- Security \u0026 auth 47: 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).\n- Payments \u0026 pricing 10: 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).\n- Task success: 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.\n- Maintenance \u0026 community 60: 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).\n- Transparency \u0026 trust 45: 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).\n\nFix list for a coding agent, everything this grade says the listing lacks, the biggest gain first (21 items): https://www.anchorterminal.com/fixes/numeral.md (JSON https://www.anchorterminal.com/fixes/numeral.json)\n\n### What we couldn't check\n\n- 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\n- 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\n- unchecked: the dashboard, including whether a free Monitoring account can create test API keys without a demo\n- Whether a status page exists. None is linked from the site, docs or help centre, and two guessed hostnames did not answer\n- The numeric rate limits for the API and the MCP server. Neither is published\n- The product page names Java, Python and Ruby SDKs. We found Go, Python and Node packages and no Java or Ruby one\n- The price of API access. The pricing page lists the tax engine and API under Enterprise as Custom\n- The privacy policy excludes platform data, so `provenance.privacy` points at the DPA, the published document that governs personal data in the product\n- lastRelease is the Last-Modified date of the 2026-03-01 OpenAPI spec, since the changelog carries no dated entry after 1 March 2026\n\n### Sources\n\n- docs index, llms.txt: \u003chttps://docs.numeral.com/llms.txt\u003e (seen 2026-10-08)\n- docs introduction: \u003chttps://docs.numeral.com/introduction.md\u003e (seen 2026-10-08)\n- quickstart: \u003chttps://docs.numeral.com/essentials/quickstart/quickstart.md\u003e (seen 2026-10-08)\n- API keys: \u003chttps://docs.numeral.com/essentials/api-keys.md\u003e (seen 2026-10-08)\n- API reference introduction, version 2026-03-01: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/introduction.md\u003e (seen 2026-10-08)\n- OpenAPI spec, version 2026-03-01: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/openapi.json\u003e (seen 2026-10-08)\n- OpenAPI spec linked from llms.txt: \u003chttps://docs.numeral.com/api-reference/openapi.json\u003e (seen 2026-10-08)\n- API changelog: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/changelog.md\u003e (seen 2026-10-08)\n- error codes: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/error-codes.md\u003e (seen 2026-10-08)\n- create calculations endpoint: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/endpoint/calculations.md\u003e (seen 2026-10-08)\n- best practices, error handling: \u003chttps://docs.numeral.com/essentials/integration-guides/best-practices.md\u003e (seen 2026-10-08)\n- AI help, skills and idempotency guidance: \u003chttps://docs.numeral.com/ai-help/overview.md\u003e (seen 2026-10-08)\n- MCP overview: \u003chttps://docs.numeral.com/mcp/overview.md\u003e (seen 2026-10-08)\n- MCP quickstart: \u003chttps://docs.numeral.com/mcp/quickstart.md\u003e (seen 2026-10-08)\n- MCP tool reference: \u003chttps://docs.numeral.com/mcp/tools.md\u003e (seen 2026-10-08)\n- MCP authentication and limits: \u003chttps://docs.numeral.com/mcp/authentication.md\u003e (seen 2026-10-08)\n- MCP health check: \u003chttps://mcp.numeralhq.com/ping\u003e (seen 2026-10-08)\n- pricing: \u003chttps://www.numeral.com/pricing\u003e (seen 2026-10-08)\n- tax engine and API product page: \u003chttps://www.numeral.com/product/api\u003e (seen 2026-10-08)\n- get-started form: \u003chttps://www.numeral.com/get-started\u003e (seen 2026-10-08)\n- terms of service: \u003chttps://www.numeral.com/legal/terms-of-service\u003e (seen 2026-10-08)\n- data processing agreement: \u003chttps://www.numeral.com/legal/dpa\u003e (seen 2026-10-08)\n- privacy policy: \u003chttps://www.numeral.com/legal/privacy-policy\u003e (seen 2026-10-08)\n- guarantee: \u003chttps://www.numeral.com/legal/guarantee\u003e (seen 2026-10-08)\n- trust centre, script-drawn and unread: \u003chttps://security.numeral.com/\u003e (seen 2026-10-08)\n- marketing llms.txt: \u003chttps://www.numeral.com/llms.txt\u003e (seen 2026-10-08)\n- security.txt, 404: \u003chttps://www.numeral.com/.well-known/security.txt\u003e (seen 2026-10-08)\n- GitHub organisation repositories: \u003chttps://github.com/NumeralHQ\u003e (seen 2026-10-08)\n- Go SDK: \u003chttps://github.com/NumeralHQ/numeral-tax-go\u003e (seen 2026-10-08)\n- Python package: \u003chttps://pypi.org/project/numeral-tax/\u003e (seen 2026-10-08)\n- npm package: \u003chttps://www.npmjs.com/package/numeral-tax\u003e (seen 2026-10-08)\n- official MCP registry search: \u003chttps://registry.modelcontextprotocol.io/v0.1/servers?search=numeral\u003e (seen 2026-10-08)\n- domain registration, numeral.com: \u003chttps://rdap.verisign.com/com/v1/domain/numeral.com\u003e (seen 2026-10-08)\n- domain registration, numeralhq.com: \u003chttps://rdap.verisign.com/com/v1/domain/numeralhq.com\u003e (seen 2026-10-08)\n\n## Who's behind it (provenance 53/100, checked 2026-10-08)\n\n| Check | Finding | Points |\n| --- | --- | --- |\n| Legal entity named | Numeral Two, Inc. | 20/20 |\n| Domain age | numeral.com, registered 1997-10-02 (29 years) | 15/15 |\n| Endpoint on the vendor's domain | api.numeralhq.com is not on numeral.com | 0/15 |\n| Terms of service | read, states 5 of the 7 things a reader expects | 8.3/10 |\n| Privacy policy | not found | 0/10 |\n| Status page | not found | 0/10 |\n| Changelog | published | 10/10 |\n| security.txt | not found | 0/10 |\n\nThe 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.\n\nThe 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.\n\nThe 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.\n\nwww.numeral.com/.well-known/security.txt returns 404, as do the same paths on www.numeralhq.com and api.numeralhq.com.\n\nNo status page was found on the site, the docs or the help centre.\n\nThe trust centre at security.numeral.com is a Oneleet page drawn by script, which we couldn't read.\n\nRDAP gives registration dates of 1997-10-02 for numeral.com and 2022-07-14 for numeralhq.com.\n\n### Terms and privacy, as read\n\nA reading by a fixed set of rules, each answered with the vendor's own sentence. Not legal advice.\n\n**Terms of service** (https://www.numeral.com/legal/terms-of-service), read 2026-10-08, gives no date, states 5 of the 7 things a reader expects.\n\n- To know. Says access can be ended without notice or for any reason. \"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\"\n- To know. Requires arbitration or waives class actions. \"It contains procedures for MANDATORY BINDING ARBITRATION AND A CLASS ACTION WAIVER.\"\n- Not found in the text. Gives the date it was last updated.\n- Names the governing law or courts. The law of the State of CALIFORNIA.\n- Says how changes to the terms are announced. Gives thirty days of notice before a change.\n- Not found in the text. Refers to a service level or uptime commitment.\n- Also in the text (2026-10-08). Numeral may use customer content to improve its services and for development of its other products, during and after the agreement. \"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\"\n- Also in the text (2026-10-08). Numeral may use the customer's name, logo and trademarks in marketing unless the customer emails to decline. \"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.\"\n- Also in the text (2026-10-08). Numeral may permanently delete all customer content when the account is terminated. \"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.\"\n\n**Privacy policy**. We found no privacy policy published for this product, so there is nothing to read and the check scores 0.\n\n\n## Live (updated 2026-10-09 02:43 UTC)\n\n- Right now: up, HTTP 200, 561 ms, checked 2026-10-09 02:43 UTC (get on `https://api.numeralhq.com`)\n- Uptime 24h 100.0% (79 probes) · 30 days 100.0% (79 probes) · p50 596 ms · p95 672 ms\n- Always current: https://www.anchorterminal.com/api/v1/live/numeral.json\n\n## Probe metrics\n\nNot measured yet. Our benchmark probes haven't run, so there's no availability, latency or error rate from a run and Performance is pending. Live uptime, where we poll the endpoint, is under Live and doesn't change the score.\n\n## Prices\n\n| Item | Price | Unit | Note |\n| --- | --- | --- | --- |\n| Filed return, Professional | $75 | per transaction | Per return filed. API access is listed under Enterprise at a custom price |\n| State registration, Professional | $150 | per transaction | One-time fee per state |\n\nAcross all listings: https://www.anchorterminal.com/prices/index.md\n\n## Strengths\n\n- 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\n- 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\n- Date-versioned API selected with the `X-API-Version` header, with a changelog and migration notes for each of four versions\n- Errors are flat JSON with `code`, `type` and `message`, and the docs list every `type`. MCP tool errors carry a stable `error_code`\n- `sk_test_` keys read and write sandbox data only, and the docs say revoking a key takes effect immediately\n\n## Weaknesses\n\n- No status page, uptime SLA or numeric rate limit was found. The product page says rate limits can be removed on request\n- The API ignores an `Idempotency-Key` header. A retried commit is safe only if the client handles `REFERENCE_ORDER_ID_ALREADY_EXISTS`\n- Secret keys carry no scopes, and the MCP server has no OAuth flow. One key reads all of the account's tax data\n- API access is listed under the Enterprise plan at a custom price, and the product page says to book a demo first\n- 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\n\n## Before you call it (notes for agents)\n\n1. Send `X-API-Version: 2026-03-01` on every call to `https://api.numeralhq.com`. Merchant, platform and certificate endpoints reject requests without it\n2. Commit with a stable `reference_order_id`. On `REFERENCE_ORDER_ID_ALREADY_EXISTS` look up the existing transaction, because `Idempotency-Key` is ignored\n3. 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`\n4. Send `amount` as the line total in minor units to `/tax/calculations` and as the per-unit price to `/tax/platform/calculations`\n5. Start with an `sk_test_` key. Certificate endpoints and MCP certificate tools are live only and answer `TESTMODE_NOT_SUPPORTED` or `live_mode_required`\n\n## Connect\n\nInstall:\n\n```bash\ngo get -u 'github.com/NumeralHQ/numeral-tax-go@v0.1.0'\n```\n\nFirst request:\n\n```bash\ncurl --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 '{ ... }'\n```\n\nClaude Code:\n\n```bash\nclaude mcp add --transport http numeral https://mcp.numeralhq.com/mcp \\\n --header \"Authorization: Bearer sk_test_...\"\n```\n\nMCP client configuration:\n\n```json\n{\n \"mcpServers\": {\n \"numeral\": {\n \"headers\": {\n \"Authorization\": \"Bearer sk_test_...\"\n },\n \"type\": \"http\",\n \"url\": \"https://mcp.numeralhq.com/mcp\"\n }\n }\n}\n```\n\nThrough letme (picks today, calling later): https://letme.dev/numeral. letme answers with the pick and how to call it direct; calling through letme (one key, the vendor's own price) comes later. How it works: https://www.anchorterminal.com/letme/index.md\n\n## Similar tools\n\nRanked by shared capabilities, then score. Same-category tools with no shared capability key are listed last.\n\n| Tool | Grade | Score | Rank | Shared capabilities | x402 | Markdown |\n| --- | --- | --- | --- | --- | --- | --- |\n| Avalara AvaTax | B | 68.8 | 172 | tax.calculate, tax.transactions, tax.exemptions, tax.filing | no | https://www.anchorterminal.com/tools/avalara.md |\n| Anrok | C | 61.6 | 361 | tax.calculate, tax.transactions, tax.exemptions, tax.filing | no | https://www.anchorterminal.com/tools/anrok.md |\n| Kintsugi | C | 60.7 | 392 | tax.calculate, tax.transactions, tax.filing, tax.exemptions | no | https://www.anchorterminal.com/tools/kintsugi.md |\n| Zamp | D | 49.5 | 609 | tax.calculate, tax.transactions, tax.filing, tax.exemptions | no | https://www.anchorterminal.com/tools/zamp.md |\n| TaxJar | C | 57.6 | 470 | tax.calculate, tax.transactions, tax.exemptions | no | https://www.anchorterminal.com/tools/taxjar.md |\n| TaxCloud | C | 57.4 | 475 | tax.calculate, tax.transactions, tax.exemptions | no | https://www.anchorterminal.com/tools/taxcloud.md |\n\n## Panel reviews (0)\n\nReviewed by the Anchor panel (https://www.anchorterminal.com/reviewers/index.md): .\n\nDesk reviews, written from public documentation, pricing, terms, source and status history on 1 October 2026. No calls made. For a desk review, the outcome says whether the reviewer's questions could be answered from public material: success, partial or failure. How reviews work: https://www.anchorterminal.com/reviews/how-it-works.md\n\n## Notable\n\n- The 2026-03-01 spec has 32 operations under `/tax` for calculations, transactions, refunds, products, customers, merchants, platform calculations and exemption certificates (source: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/openapi.json\u003e)\n- 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 (source: \u003chttps://docs.numeral.com/mcp/tools\u003e)\n- 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 (source: \u003chttps://docs.numeral.com/mcp/tools\u003e)\n- 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 (source: \u003chttps://docs.numeral.com/ai-help/overview\u003e)\n- Version 2026-03-01 added tax calculation from a customer's IP address with four resolution modes (strict, zero, approximate, best_effort) (source: \u003chttps://docs.numeral.com/api-reference/v2026-03-01/changelog\u003e)\n- The terms let Numeral use customer content to improve the services and other Numeral offerings, and disclose it in aggregate or de-identified form (source: \u003chttps://www.numeral.com/legal/terms-of-service, section 3\u003e)\n- The only server named numeral in the official MCP registry is `io.usefulapi/numeral`, published by a third party and not by Numeral (source: \u003chttps://registry.modelcontextprotocol.io/v0.1/servers?search=numeral\u003e)\n\n## Compare\n\n- [Anrok vs Numeral](https://www.anchorterminal.com/compare/anrok-vs-numeral.md): C 61.6 vs D 49.3\n- [Avalara AvaTax vs Numeral](https://www.anchorterminal.com/compare/avalara-vs-numeral.md): B 68.8 vs D 49.3\n- [Fonoa vs Numeral](https://www.anchorterminal.com/compare/fonoa-vs-numeral.md): D 51.7 vs D 49.3\n- [Kintsugi vs Numeral](https://www.anchorterminal.com/compare/kintsugi-vs-numeral.md): C 60.7 vs D 49.3\n- [Numeral vs Quaderno](https://www.anchorterminal.com/compare/numeral-vs-quaderno.md): D 49.3 vs C 59.5\n- [Numeral vs TaxCloud](https://www.anchorterminal.com/compare/numeral-vs-taxcloud.md): D 49.3 vs C 57.4\n- [Numeral vs TaxJar](https://www.anchorterminal.com/compare/numeral-vs-taxjar.md): D 49.3 vs C 57.6\n- [Numeral vs Vertex O Series](https://www.anchorterminal.com/compare/numeral-vs-vertex-tax.md): D 49.3 vs C 54.7\n- [Numeral vs Zamp](https://www.anchorterminal.com/compare/numeral-vs-zamp.md): D 49.3 vs D 49.5\n\n## Verify this listing\n\nFor the vendor. The badge or a plain link to this page verifies the listing, from a page on numeral.com or one of its subdomains, or the README of github.com/NumeralHQ/numeral-tax-go. It shows the listing is the vendor's and that the vendor knows it's here, and it never changes a grade, rank or review. The vendor sends the page's address to `POST https://www.anchorterminal.com/api/v1/verify` as `{\"slug\": \"numeral\", \"url\": \"…\"}`, or calls the `verify_listing` tool at https://www.anchorterminal.com/mcp. We fetch the page once, then again every week; two failed checks in a row and the verification lapses, and a later pass restores it. What we check: https://www.anchorterminal.com/builders/index.md#verify\n\nHTML badge:\n\n```html\n\u003ca href=\"https://www.anchorterminal.com/tools/numeral\"\u003e\u003cimg src=\"https://www.anchorterminal.com/badges/numeral.svg\" alt=\"Numeral on Anchor Terminal\" height=\"20\"\u003e\u003c/a\u003e\n```\n\nMarkdown badge, for a README:\n\n```markdown\n[![Numeral on Anchor Terminal](https://www.anchorterminal.com/badges/numeral.svg)](https://www.anchorterminal.com/tools/numeral)\n```\n\nPlain link:\n\n```html\n\u003ca href=\"https://www.anchorterminal.com/tools/numeral\"\u003eNumeral on Anchor Terminal\u003c/a\u003e\n```\n\n## Share this listing\n\nFor the vendor. Sharing assets for social media, two PNGs of 1200 × 630 that say Numeral is listed on Anchor Terminal, with the vendor's logo and this page's address and no grade or score.\n\n- Dark: https://www.anchorterminal.com/assets/share/numeral-dark.png\n- Light: https://www.anchorterminal.com/assets/share/numeral-light.png\n", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-10-09", "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" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Terminal", "url": "https://www.anchorterminal.com/tools/" }, { "name": "Tax calculation \u0026 compliance", "url": "https://www.anchorterminal.com/categories/tax" }, { "name": "Numeral", "url": "" } ], "description": "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.", "facts": [ "rank #611 of 722", "API key auth", "0 desk reviews" ], "h1": "Numeral", "image": "https://www.anchorterminal.com/assets/og/tools-numeral.png", "path": "/tools/numeral", "published": "2026-10-01", "section": "tools", "title": "Numeral review for AI agents, grade D (49.3/100) | Anchor Terminal", "toc": null, "updated": "2026-10-09", "url": "https://www.anchorterminal.com/tools/numeral" }, "tokens": { "markdown": 7700, "slim": 1880 }, "version": 1 }