Alpaca Trading API integration for Model Context Protocol (MCP)
Taxlocus is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
TaxLocus gives AI agents US sales tax answers they can cite. Ask for a rate, a nexus check or a taxability rule and you get the answer with the official source it came from: the state or county document, its URL and its date.
TaxLocus is a remote MCP server at https://api.taxlocus.com/mcp (streamable HTTP). There is nothing to install and no API key to paste: your client signs you in with OAuth the first time it connects.
What it does
- Rates for an address. Combined sales tax rate for a US street address or latitude/longitude, broken down by state, county or parish, city, special district and transit district, with a citation on every line. Includes the state's sourcing rule, so you know whether to rate the seller's or the buyer's location.
- Economic nexus. Checks year-to-date sales and transaction counts against each state's current threshold, or tracks a seller's sales over time and reports how close it is to each threshold.
- Taxability. Whether a product category (groceries, clothing, prescription drugs, software, digital goods and more) is taxable in a state, at what treatment, with the rule's source.
- Filing. A state's filing frequency and upcoming return due dates, and a record of which periods you've filed.
- Payroll reference data. Federal FICA and FUTA, state income tax, state unemployment (SUTA) wage bases, local income tax jurisdictions (PA, OH, IN, MD, MI, NY, MO, DE) and state reciprocity agreements.
- Workpapers you can replay. Every rate answer gets a
call_id. TaxLocus stores the request and answer with SHA-256 hashes, so you can pull it back later for an auditor, or replay it against today's data to see exactly what changed since and why.
The 16 tools
Read (no changes to your account)
lookup_rate: combined rate, jurisdiction breakdown, taxability and citations for an address or pointcheck_nexus: whether given sales cross a state's economic-nexus thresholdtaxability_check: whether product categories are taxable in a statefiling_calendar: filing frequency and upcoming due dates for a statelookup_payroll_rates: federal and state payroll tax reference dataget_workpaper: the stored request and answer for an earlier callreplay_workpaper: re-run an earlier answer against today's data and show the differenceslist_entities: the seller entities your account tracksnexus_status: a tracked entity's running nexus status in every state it has sales in
Write (change data in your account)
create_entity: start tracking a seller entityupdate_entity: change an entity's name, home state, timezone or locationrecord_transaction: add a sale to an entity's ledger (idempotent)record_refund: book a full or partial refund against the ledgerset_registration: record whether you're registered to collect in a stateset_filing_frequency: record the frequency a state assigned youmark_period_filed: mark a filing period as filed, or clear the mark
The write tools only touch your own account's tracking data. None of them file a return or contact a state.
Coverage
- All 50 states plus DC
- State, county, parish, city, special district and transit rates, refreshed from official state sources
- Every change to a rate is logged with its source and date
Free tier and sign-in
The first time you connect, a browser window opens: enter your email, click the link we send, and approve access. If you don't have a TaxLocus account, a free account is created for you: 1,000 lookups a month, no credit card, including nexus tracking for one entity. Paid plans raise the limits. Clients that can't do OAuth can use an API key from https://taxlocus.com/keys instead.
Example prompts
- "What's the sales tax on a $250 order shipped to 414 E 12th St, Kansas City, MO 64106? Show me where each part of the rate comes from."
- "We sold $112,000 into Texas and $85,000 into Washington this year across 140 orders. Do we have economic nexus in either state?"
- "Is SaaS taxable in New York, Texas and Pennsylvania? And replay the rate answer from call
<call_id>against today's data: has anything changed?"
TaxLocus data is informational and not tax or legal advice. Each answer carries its source so you can check it.
Setup guide: https://github.com/Ringzero787/taxlocus-skills/blob/main/INSTALL.md · More: https://taxlocus.com/mcp
Quickstart
Install it the way its author documents:
The full guide: https://github.com/Ringzero787/taxlocus-skills/blob/main/INSTALL.md
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Install it the way its author documents:
The full guide: https://github.com/Ringzero787/taxlocus-skills/blob/main/INSTALL.md
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Resolve the combined sales-tax rate, jurisdiction breakdown, taxability flag, and sourcing rule for a location (lat/lng or address) and product category. Categories use a dotted taxonomy (e.g. goods.general, food.grocery, software.saas); common aliases like general/groceries/saas are also accepted. The rate is for the location you send unless you also send seller_location, or an entity_id whos
| Parameter | Type | Required | Notes |
|---|---|---|---|
| lat | number | no | — |
| lng | number | no | — |
| address | object | no | — |
| product_category | string | yes | Product category. Canonical codes use a dotted taxonomy — e.g. goods.general, food.grocery, food.prepared, clothing.general, software.saas, software.prewritten, medical.rx, medical.otc, publications.b |
| sale_amount | number | no | — |
| as_of | string | no | — |
| customer_ref | string | no | — |
| sku | string | no | — |
| b2b | boolean | no | — |
| seller_location | object | no | Optional. The seller's place of business for this sale: where the order is received or the goods ship from. When it is in the same state as the delivery address and that state sources in-state sales t |
| entity_id | string | no | Optional. A tracked entity of yours. When you send no seller_location and the entity has a stored business location, that location is used as seller_location, and sourcing_detail says so (seller_locat |
Given year-to-date sales and transaction counts, report whether a seller has crossed a state's economic-nexus threshold.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state | string | yes | — |
| ytd_sales | number | yes | — |
| ytd_transactions | integer | yes | — |
| include_marketplace_sales | boolean | no | — |
Return a state's filing frequency and upcoming sales-tax return due dates. Frequency is assigned on annual tax liability — pass annual_tax_collected for accuracy, or annual_revenue to estimate it via the state rate.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state | string | yes | — |
| annual_tax_collected | number | no | — |
| annual_revenue | number | no | — |
| registration_date | string | no | — |
Report whether one or more product categories are taxable in a state, with the treatment, the rule's confidence and source citation. A provisional or inferred rule is not settled: say so. Categories use a dotted taxonomy (e.g. goods.general, food.grocery, software.saas); common aliases like general/groceries/saas are also accepted.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state | string | yes | — |
| product_category | string | no | Product category. Canonical codes use a dotted taxonomy — e.g. goods.general, food.grocery, food.prepared, clothing.general, software.saas, software.prewritten, medical.rx, medical.otc, publications.b |
| product_categories | array | no | Product category. Canonical codes use a dotted taxonomy — e.g. goods.general, food.grocery, food.prepared, clothing.general, software.saas, software.prewritten, medical.rx, medical.otc, publications.b |
Return federal payroll-tax constants (FICA + FUTA), state personal income tax top-line, state SUTA wage base, any local income-tax jurisdictions for the state (PA EIT, OH municipal, MD county, NYC/Yonkers, etc.), and state-to-state reciprocity agreements. Reference data only — not a withholding-calculation engine; the consumer applies these rates against W-4 / wage data. Same corpus as the open da
| Parameter | Type | Required | Notes |
|---|---|---|---|
| state | string | yes | — |
| year | integer | no | Tax year; defaults to the current calendar year. A section with no rows for this year is served from its latest earlier year, with year_served and fallback: true on that section. |
| locality | string | no | Filter local income-tax jurisdictions by name, case-insensitive substring match (e.g. 'Pittsburgh', 'Shaler'). Strongly recommended in states with thousands of jurisdictions such as PA and OH. |
| limit | integer | no | Max local jurisdictions to return. |
| offset | integer | no | Local jurisdictions to skip, for paging. |
Append a sale to a tracked entity's ledger. Updates the running economic-nexus totals and returns the entity's threshold status for that state. Idempotent on idempotency_key.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| entity_id | string | yes | — |
| state | string | yes | — |
| sale_amount | number | yes | — |
| transaction_date | string | no | — |
| is_marketplace | boolean | no | — |
| is_exempt | boolean | no | — |
| external_ref | string | no | — |
| idempotency_key | string | no | — |
| county_fips | string | no | — |
| place_geoid | string | no | — |
| tax_collected | number | no | — |
| lat | number | no | — |
| lng | number | no | — |
| address | object | no | — |
| call_id | string | no | — |
| tax_source | string | no | — |
| platform_tax_lines | array | no | — |
Book a full or partial refund against a tracked entity's ledger and return the entity's updated threshold status for that state. Pass POSITIVE refund_amount / tax_refunded — the service stores them negative so ledger totals net. Supply refunded_ref (the original sale's external_ref) where possible: the refund then inherits that sale's exempt/marketplace/jurisdiction fields, and cumulative refunds
| Parameter | Type | Required | Notes |
|---|---|---|---|
| entity_id | string | yes | — |
| state | string | no | — |
| refund_amount | number | yes | — |
| tax_refunded | number | no | — |
| refund_date | string | no | — |
| refunded_ref | string | no | — |
| external_ref | string | no | — |
| idempotency_key | string | no | — |
| is_marketplace | boolean | no | — |
| is_exempt | boolean | no | — |
| county_fips | string | no | — |
| place_geoid | string | no | — |
| lat | number | no | — |
| lng | number | no | — |
| address | object | no | — |
Return a tracked entity's running economic-nexus status across every state it has recorded sales in, with distance to threshold.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| entity_id | string | yes | — |
Return the request and response TaxLocus stored for one earlier call (the call_id on a lookup_rate or cart response), the SHA-256 hashes written when it was answered, and whether the stored bodies still match them. Use it to reprint what TaxLocus told you for an invoice. Not metered.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| call_id | string | yes | — |
Re-run a stored lookup_rate or cart answer with its original as_of and rated point against today's data. Returns both answers, the differences, and the dated, cited corpus changes in that state since the original corpus_version. Not metered.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| call_id | string | yes | — |
List the account's tracked seller entities (archived ones are left out): id, name, home_state, timezone and the stored business location (null when none is set). Use an id from here as entity_id in record_transaction, nexus_status, the filing tools, and lookup_rate. Not metered.
Takes no parameters.
Create a seller entity to track economic nexus for: a name, and optionally its home_state, IANA timezone and business location (a street address, or lat and lng). An address is matched once, when it is saved; report location.resolution to the user: zip_centroid means the street did not match and the location is the ZIP code's centre, so ask for a corrected address. Free and Indie accounts ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| home_state | string | no | — |
| location | object | no | The business's place of business: where orders are received or goods ship from. Used as the seller location on lookup and cart calls that send this entity's entity_id and no seller_location. |
| timezone | string | no | — |
Change an entity's name, home_state, timezone or business location. Only the fields you send change; home_state, timezone or location set to null clears it, so send null only when the user asks to remove it. The location is used as the seller location on lookup_rate calls that pass this entity_id and no seller_location. Report what changed, and location.resolution when the location was set (`z
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | — |
| home_state | no | — | |
| timezone | no | — | |
| location | no | The business's place of business: where orders are received or goods ship from. Used as the seller location on lookup and cart calls that send this entity's entity_id and no seller_location. | |
| entity_id | string | yes | The entity's id, from list_entities or create_entity. |
Record whether the business is registered to collect sales tax in a state where the entity is tracked (it has recorded sales there; otherwise state_not_tracked). registered: false clears it. Returns the state's filing obligation: nexus_status, registered, filing_frequency (monthly is assumed until set: see filing_frequency_set), next_due, and, once nexus is met and the business is registered, the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| registered | boolean | yes | true: the business is registered to collect sales tax in this state. false: clears the registration. |
| entity_id | string | yes | The entity's id, from list_entities or create_entity. |
| state | string | yes | Two-letter state code (the 50 states or DC), e.g. TX. |
Record the filing frequency a state assigned the business: monthly, quarterly or annual (the state's registration letter or portal says which). The entity must be tracked in the state. Returns the state's filing obligation with the returns listed for the new frequency; report the next due date. Not metered.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| frequency | string | yes | The filing frequency the state assigned: monthly, quarterly or annual. |
| entity_id | string | yes | The entity's id, from list_entities or create_entity. |
| state | string | yes | Two-letter state code (the 50 states or DC), e.g. TX. |
Mark the return for one filing period as filed (filed: true), or remove the mark (filed: false). The period label must match the state's filing frequency: YYYY-MM for monthly, YYYY-Qn for quarterly, YYYY for annual (period_frequency_mismatch otherwise; set_filing_frequency first if the frequency is wrong). Only mark a period filed when the user says the return was filed. Returns the period, filed
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filed | boolean | yes | true: the return for this period was filed. false: unmarks it. |
| entity_id | string | yes | The entity's id, from list_entities or create_entity. |
| state | string | yes | Two-letter state code (the 50 states or DC), e.g. TX. |
| period | string | yes | The filing period: YYYY-MM for a monthly filer, YYYY-Qn for quarterly (calendar quarters), YYYY for annual. It must match the state's filing frequency. |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Taxlocus or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.1.0.
No release note was published with this version.
- The version this listing was on when mcprush began following its releases. The registry was not asked when it shipped, so this row carries no date.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Taxlocus can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.