Skip to content

How Numeral’s scores are calculated

The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.

verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10

PA Score20/100

Agent-ready 43.3 × 0.30 = 12.99

API quality 6.9 × 0.20 = 1.38

Openness 14.4 × 0.20 = 2.88

Built-in AI 21.3 × 0.15 = 3.19

Automation 0.0 × 0.15 = 0.00

(12.99 + 1.38 + 2.88 + 3.19 + 0.00) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 20.45 ÷ 1.00 = 20.4

Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.

Agent-ready43.3/100×0.30 of the PA blend

Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.

Point an agent at llms.txt or agent-oriented docsweight 2

2 (weight) × 9 (quality) × 1.0 (full) = 18.0 of 20 max

  • [probe] https://docs.numeral.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.numeral.com/llms.txt # Numeral API - [Introduction](https://docs.numeral.com/introduction.md): Numeral API - [Quickstart](https://docs.numer
  • [claimed-docs] https://docs.numeral.com/ai-help/overview.mdClaude skills that teach an AI coding agent how to integrate the Numeral tax API correctly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.

Run the product headlessly / in CI for automationweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [claimed-docs] https://docs.numeral.com/essentials/quickstart/quickstart.mdCreate a product with a POST to `/tax/products`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/transactions.mdAfter you make a sale, you'll want to create a `transaction`. First, though, you'll have to have made a `calculation`
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [probe] https://docs.numeral.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.numeral.com/llms.txt # Numeral API - [Introduction](https://docs.numeral.com/introduction.md): Numeral API - [Quickstart](https://docs.numer

Plug MCP servers into this product so it can use their toolsweight 3

n/a — not applicable to this product: excluded from numerator and denominator

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [probe] https://docs.numeral.com/mcp/overviewofficial MCP server documented at https://docs.numeral.com/mcp/overview

Connect an agent via an official MCP serverweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts
  • [probe] https://docs.numeral.com/mcp/overviewofficial MCP server documented at https://docs.numeral.com/mcp/overview

Use an official CLIweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Drive the product through a documented public APIweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [claimed-docs] https://docs.numeral.com/essentials/quickstart/quickstart.mdCreate a product with a POST to `/tax/products`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/transactions.mdAfter you make a sale, you'll want to create a `transaction`. First, though, you'll have to have made a `calculation`
  • [claimed-docs] https://docs.numeral.com/api-reference/v2026-03-01/introduction.mdYou can now pass `customer.ip` instead of (or in addition to) `customer.address`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/exemption-certificates.md`certificate_request` — an outstanding ask for an exemption certificate from one of your customers. Trigger one, read its state, cancel it.
  • [probe] https://docs.numeral.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.numeral.com/llms.txt # Numeral API - [Introduction](https://docs.numeral.com/introduction.md): Numeral API - [Quickstart](https://docs.numer
  • [probe] https://docs.numeral.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.numeral.com/openapi.json, https://docs.numeral.com/swagger.json, https://docs.numeral.com/api/openapi.json, https://docs.numeral.com/.well-known/openapi.json)

Issue scoped/least-privilege API credentials for an agentweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts

Build against official SDKsweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://docs.numeral.com/essentials/quickstart/quickstart.mdCreate a product with a POST to `/tax/products`
  • [claimed-docs] https://docs.numeral.com/ai-help/overview.mdClaude skills that teach an AI coding agent how to integrate the Numeral tax API correctly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [probe] https://docs.numeral.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.numeral.com/llms.txt # Numeral API - [Introduction](https://docs.numeral.com/introduction.md): Numeral API - [Quickstart](https://docs.numer
  • [probe] https://docs.numeral.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.numeral.com/openapi.json, https://docs.numeral.com/swagger.json, https://docs.numeral.com/api/openapi.json, https://docs.numeral.com/.well-known/openapi.json)

Subscribe to events via webhooksweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Agent-ready = 78.0 ÷ 180 × 100 = 43.3

API quality6.9/100×0.20 of the PA blend

The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.

Explore an interactive API reference with runnable examplesweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.numeral.com/essentials/quickstart/quickstart.mdCreate a product with a POST to `/tax/products`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/transactions.mdAfter you make a sale, you'll want to create a `transaction`. First, though, you'll have to have made a `calculation`
  • [probe] https://docs.numeral.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.numeral.com/openapi.json, https://docs.numeral.com/swagger.json, https://docs.numeral.com/api/openapi.json, https://docs.numeral.com/.well-known/openapi.json)

Download a machine-readable API spec (OpenAPI or equivalent)weight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://docs.numeral.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.numeral.com/openapi.json, https://docs.numeral.com/swagger.json, https://docs.numeral.com/api/openapi.json, https://docs.numeral.com/.well-known/openapi.json)
  • [probe] https://docs.numeral.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.numeral.com/llms.txt # Numeral API - [Introduction](https://docs.numeral.com/introduction.md): Numeral API - [Quickstart](https://docs.numer

Test against a sandbox environment without touching production dataweight 1

1 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 10 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Rely on versioned APIs with a documented deprecation policyweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/transactions.mdAfter you make a sale, you'll want to create a `transaction`. First, though, you'll have to have made a `calculation`
  • [claimed-docs] https://docs.numeral.com/api-reference/v2026-03-01/introduction.mdYou can now pass `customer.ip` instead of (or in addition to) `customer.address`

API quality = 4.8 ÷ 70 × 100 = 6.9

Openness14.4/100×0.20 of the PA blend

Can you leave, inspect, or self-host — data export, open source, portability.

Do everything through the API that I can do in the UIweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://docs.numeral.com/essentials/quickstart/quickstart.mdCreate a product with a POST to `/tax/products`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/transactions.mdAfter you make a sale, you'll want to create a `transaction`. First, though, you'll have to have made a `calculation`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/exemption-certificates.md`certificate_request` — an outstanding ask for an exemption certificate from one of your customers. Trigger one, read its state, cancel it.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts
  • [probe] https://docs.numeral.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.numeral.com/openapi.json, https://docs.numeral.com/swagger.json, https://docs.numeral.com/api/openapi.json, https://docs.numeral.com/.well-known/openapi.json)

Export all of my data in open formats and leaveweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Read the product's source under an open licenseweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Self-host the core productweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Openness = 7.2 ÷ 50 × 100 = 14.4

Built-in AI21.3/100×0.15 of the PA blend

Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.

Get AI-generated insights and suggestions from my data inside the productweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts

Set up automations that run autonomously in the backgroundweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts
  • [claimed-docs] https://www.numeral.comRegister, file, and remit across US and global jurisdictions, on time, every time.
  • [claimed-docs] https://www.numeral.comWe scan, read, and respond to all your sales tax mail from state and local governments.
  • [claimed-docs] https://www.numeral.com/pricingAutomatically validate each uploaded certificate * Expiration tracking, renewals, and compliance monitoring

Delegate tasks to a built-in AI assistant inside the productweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [claimed-docs] https://docs.numeral.com/ai-help/overview.mdClaude skills that teach an AI coding agent how to integrate the Numeral tax API correctly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"

Operate the product with natural-language commandsweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts
  • [probe] https://docs.numeral.com/mcp/overviewofficial MCP server documented at https://docs.numeral.com/mcp/overview

Built-in AI = 19.2 ÷ 90 × 100 = 21.3

Automation0.0/100×0.15 of the PA blend

Depth of automation primitives — rules, scheduling, bulk operations, webhooks.

Perform bulk operations across many items at onceweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.numeral.com/essentials/quickstart/quickstart.mdCreate a product with a POST to `/tax/products`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/transactions.mdAfter you make a sale, you'll want to create a `transaction`. First, though, you'll have to have made a `calculation`
  • [claimed-docs] https://docs.numeral.com/v2026-03-01/objects/exemption-certificates.md`certificate_request` — an outstanding ask for an exemption certificate from one of your customers. Trigger one, read its state, cancel it.

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Schedule recurring jobs or workflowsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdThe Numeral MCP server is a single HTTPS endpoint that exposes your Numeral account — nexus, filings, registrations, transactions, sales, products, and exemption certificates — as tools an AI agent can call directly.
  • [claimed-docs] https://docs.numeral.com/mcp/overview.mdstart answering questions like "which states have I triggered nexus in, and are any filings waiting on my review?"
  • [claimed-docs] https://docs.numeral.com/mcp/tools.mdThe account's current nexus position per jurisdiction: whether nexus has been triggered (economic and/or physical), the economic thresholds with current sales and transaction counts
  • [claimed-docs] https://www.numeral.comRegister, file, and remit across US and global jurisdictions, on time, every time.
  • [claimed-docs] https://www.numeral.com/pricingAutomatically validate each uploaded certificate * Expiration tracking, renewals, and compliance monitoring

Version, review, and roll back my automationsweight 1

1 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 10 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Automation = 0.0 ÷ 80 × 100 = 0.0