Repository avatar
AI Tools
v1.1.0
active

taxlocus

com.taxlocus/taxlocus

US sales tax for AI agents: rates, economic nexus, taxability, filing. Citation-backed.

Documentation

TaxLocus MCP & Agent Skills

Taxlocus MCP server

Official Model Context Protocol (MCP) server reference and Agent Skills for working with US sales tax and payroll tax via TaxLocus:

  • Remote MCP Server (Streamable HTTP): https://api.taxlocus.com/mcp
  • REST API: https://api.taxlocus.com (OpenAPI docs)
  • Registry Manifest: server.json (com.taxlocus/taxlocus)

Connecting to the Remote MCP Server

TaxLocus exposes a stateless Streamable HTTP MCP server at https://api.taxlocus.com/mcp. It supports both OAuth 2.1 (RFC 9728 Protected Resource Metadata at https://api.taxlocus.com/.well-known/oauth-protected-resource) and Bearer API keys (tlx_live_... or tlx_test_... from taxlocus.com).

Claude Code / Claude Desktop / Cursor (Bearer API Key)

{
  "mcpServers": {
    "taxlocus": {
      "type": "http",
      "url": "https://api.taxlocus.com/mcp",
      "headers": {
        "Authorization": "Bearer tlx_live_YOUR_KEY"
      }
    }
  }
}

Interactive OAuth 2.1 (Claude Connectors / MCP Clients with OAuth Discovery)

Point your OAuth-capable MCP client directly at:

https://api.taxlocus.com/mcp

The server challenges unauthenticated requests with 401 Unauthorized and WWW-Authenticate: Bearer resource_metadata="https://api.taxlocus.com/.well-known/oauth-protected-resource", guiding the client through PKCE sign-in.


Available MCP Tools (16)

ToolRead-OnlyMeteredDescription
lookup_rateYesYesResolve the combined sales-tax rate, jurisdiction breakdown, taxability flag, sourcing rule, warnings, and primary-source citations for a US address or lat/lng and product category.
check_nexusYesYesGiven year-to-date sales and transaction counts, report whether a seller has crossed a state's economic-nexus threshold.
filing_calendarYesYesReturn a state's filing frequency and upcoming sales-tax return due dates based on annual tax liability or revenue.
taxability_checkYesYesReport whether one or more product categories are taxable in a state, with treatment, confidence, and source citation.
lookup_payroll_ratesYesYesReturn federal payroll-tax constants (FICA + FUTA), state PIT top-line, state SUTA wage base, local income-tax jurisdictions, and state reciprocity agreements.
get_workpaperYesNoFetch the stored request, response, and SHA-256 verification hashes for an earlier lookup_rate or cart call (call_id).
replay_workpaperYesNoRe-run a stored lookup_rate or cart call against today's corpus and return any differences and dated citations since the original corpus_version.
list_entitiesYesNoList the account's tracked seller entities (id, name, home_state, timezone, and stored business location).
create_entityNoNoCreate a tracked seller entity with optional home_state, IANA timezone, and business location.
update_entityNoNoUpdate a tracked entity's name, home_state, timezone, or business location.
record_transactionNoNoAppend a sale to a tracked entity's ledger (idempotent on idempotency_key) and return updated state nexus status.
record_refundNoNoBook a full or partial refund against a tracked entity's ledger and return updated state nexus status.
nexus_statusYesNoReturn a tracked entity's running economic-nexus status across every state where it has recorded sales, with distance to threshold.
set_registrationNoNoRecord or clear whether a tracked entity is registered to collect sales tax in a state, and return its filing obligation.
set_filing_frequencyNoNoRecord the filing frequency (monthly, quarterly, annual) assigned by a state for a tracked entity.
mark_period_filedNoNoMark or unmark a sales-tax return period (YYYY-MM, YYYY-Qn, or YYYY) as filed for a tracked entity.

Agent Skills

Each skill lives in its own folder with a SKILL.md:

SkillFolderWhat it does
taxlocus-sales-taxtaxlocus-sales-tax/Guides Claude in using the TaxLocus MCP connector to answer US sales tax questions — rate lookups, economic nexus, product taxability, and filing calendars. Picks the right tool, applies correct sourcing/nexus rules, treats unknown taxability as "verify" (not exempt), surfaces source citations, and enforces the US-only / not-tax-advice guardrails.
taxlocus-payroll-taxtaxlocus-payroll-tax/Guides Claude in answering US payroll-tax questions via TaxLocus — federal FICA/FUTA, state PIT and SUTA wage bases, state reciprocity, and local income tax in 8 states (PA, OH, IN, MD, MI, NY, MO, DE). Surfaces coverage gaps honestly for non-covered states, refuses to compute paycheck withholding, and enforces the not-tax-advice / not-withholding-tables guardrail.
taxlocus-apitaxlocus-api/Guides AI coding assistants in integrating the TaxLocus REST API / MCP into a codebase — rate lookups, cart/checkout tax calculation, economic-nexus tracking, taxability, exemption certificates, and state-return worksheets (local schedules are not filled in).

Links

License

Apache-2.0. TaxLocus output is informational only — not tax or legal advice; verify against the cited source before relying on a value for compliance.


License

The skills and reference files in this repository are released under the MIT License. The TaxLocus API, MCP server and rate data are a separate hosted service with their own Terms of Service; the open rate tables are published under CC-BY-4.0 at taxlocus-data. "TaxLocus" and its logo are not licensed under MIT.

No installation packages available.

Remote