Documentation
Tools exposed by Sales Tax Nexus Tracker and the limits that apply.
Connect
Server URL: https://nexus.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
threshold_lookup
Returns the registration threshold for one state, DC, the EU or the UK, with the official source page and the date it was verified. With no jurisdiction it lists every row.
- Inputs: jurisdiction (optional): a state code or name, DC, EU or UK
- Limits: Counts one lookup. Free plan: 100 per month.
check_nexus
Totals sales by state and month over each jurisdiction's measurement period and reports crossed, approaching (80%) or below, with the month first reached.
- Inputs: data (CSV or JSON text) or csv_url (a public CSV link), rows_are_orders (optional), as_of (optional month)
- Limits: Counts one check. Free plan: 1 per month, up to 12 months and 10 states, US states only. Pro: up to 36 months, all jurisdictions.
set_profile
Saves your home state (a physical presence state) and whether all your sales go through marketplaces that collect the tax.
- Inputs: home_state (optional), clear_home_state (optional), marketplace_only (optional)
- Limits: No quota.
watch_nexus
Saves monthly sales data as a named watch that is re-checked each month; an email is sent at 80% and at 100% of a threshold. Saving again with the same name adds to or replaces months.
- Inputs: name, data or csv_url, rows_are_orders (optional), merge (optional)
- Limits: Pro plan only. Up to 5 watches. Does not use a check.
list_nexus_watches
Lists saved watches with their data range and the jurisdictions flagged at the last check.
- Inputs: none
- Limits: No quota.
remove_nexus_watch
Removes one saved watch and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
get_nexus_alerts
Lists threshold alerts from saved watches, unseen first, and marks them seen.
- Inputs: limit (optional)
- Limits: No quota.
nexus_report
Builds a hosted, shareable HTML report of a nexus check, with a CSV download, from pasted data or a saved watch.
- Inputs: data or csv_url or watch_name, rows_are_orders (optional), as_of (optional), title (optional)
- Limits: Pro plan only. Counts one check. Reports are kept for 90 days.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| threshold lookups | 100 | 2000 |
| nexus checks and reports | 1 | 200 |
| saved watches | 0 | 5 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://nexus.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.