Setup
Use the public plugin listing for ChatGPT or Claude. Use the manual server URL only for other MCP-compatible clients or when you specifically need a custom connection.
Claude
- Open Claude or Claude Desktop and choose Customize in the left sidebar.
- Open Plugins, then Discover.
- Search for
TaxMCP, select it, and click Add. - Complete the TaxMCP sign-in and authorization when Claude prompts you.
Claude plugins are available on paid plans and may be controlled by workspace policy.
ChatGPT
- Open the TaxMCP plugin listing, or open Plugins and search for
TaxMCP. - Select the listing published by Gray & Company.
- Click Install plugin.
- Connect and sign in to TaxMCP when prompted.
Other MCP clients and manual setup
For Cursor, Windsurf, Continue, Claude Code, or another compatible client, add TaxMCP as a remote Streamable HTTP server. Use OAuth when the client asks how the connection authenticates.
https://app.taxmcp.io/mcp The client will register automatically, open a browser for TaxMCP sign-in and authorization, then return to the client with the connection enabled. Do not add a trailing slash to the URL.
Example prompts
What to type, which tool fires, and what the model gets back to ground its answer.
search-tax-law “What's the QBI deduction and how does the phase-out work?”
What happens search-tax-law returns ranked excerpts from §199A with subsection identifiers and a citation URL to uscode.house.gov. Claude grounds its explanation in those excerpts.
lookup-section “Pull up Section 1031 for me.”
What happens lookup-section returns the full statutory text of IRC §1031 with subsection structure and a citation URL.
get-cross-references “What other tax code sections reference §199A?”
What happens get-cross-references returns the inbound and outbound citation graph for §199A: which sections it cites, and which cite back to it.
get-publication “What does Publication 946 say about MACRS recovery periods for residential rental property?”
What happens get-publication retrieves the relevant section of Pub. 946 with a citation URL back to irs.gov.
get-case “Pull up the Soroban Capital Partners opinion on the limited-partner SE-tax exception.”
What happens get-case returns the full text of Soroban Capital Partners LP v. Commissioner (T.C. Memo. 2025-52) with a citation URL; long opinions are paginated. Requires a Pro+ subscription.
get-citing-cases “What later Tax Court opinions cite Renkemeyer?”
What happens get-citing-cases returns the citation graph for Renkemeyer, Campbell & Weaver, LLP v. Commissioner: how many later opinions cite it and which it cites. Reflects citation activity, not authoritative treatment. Requires a Pro+ subscription.
search-tax-law “Does Georgia conform to federal §163(j) interest limits?”
What happens search-tax-law with jurisdiction=state_ga returns relevant excerpts from Georgia's tax code. Requires a Pro+ subscription for state access.
Tools reference
All seven tools are read-only. Every result includes a citation URL back to the primary source (uscode.house.gov, ecfr.gov, irs.gov, or the state legislature).
search-tax-law · Search Tax Law Semantic search across the IRC, Treasury Regs, IRS Publications, Revenue Rulings, Revenue Procedures, and Notices, with an optional jurisdiction filter for state codes. Each result includes a source-type label, effective date, last-amended date with the most recent Public Law, and a citation URL to the primary source; superseded IRS guidance is flagged.
Parameters
-
querystring · required · The natural-language question or keyword phrase. -
jurisdictionstring · optional · Restrict to a state (e.g. state_ga for Georgia). Requires Pro+. -
source_typestring · optional · Restrict by source: irc, treasury_reg, publication, revenue_ruling, notice, state_tax_code. -
limitinteger · optional · Maximum number of results to return (1–20, default 5).
lookup-section · Look Up Tax Code Section Direct lookup of a specific IRC section, Treasury Regulation, or state statute by identifier, down to the subsection level (e.g. §168(k) returns just that subsection). Returns the full statutory text with citation URL, effective dates, and an Amendments & Effective Dates block with the last-amended date and Public Law citation. Oversized sections return a navigable subsection index instead of truncating.
Parameters
-
sectionstring · required · Section identifier, e.g. 199A, 1.280A-2, or AL-40-18-1 for state codes. -
source_typestring · optional · Disambiguate when an identifier is ambiguous. -
include_refsboolean · optional · Include cross-references in the response (default true).
get-publication · Get IRS Publication Retrieve plain-language IRS Publication content by number. Useful when statutory text is too dense.
Parameters
-
numberstring · required · Publication number, e.g. 946, 334, 17. -
sectionstring · optional · Restrict to a specific section of the publication.
get-ruling · Get IRS Ruling or Notice Retrieve a specific Revenue Ruling, Revenue Procedure, or Notice by identifier. Flags when the IRS has superseded, obsoleted, or revoked the document and names the superseding guidance.
Parameters
-
identifierstring · required · e.g. Rev. Rul. 2024-01, Rev. Proc. 2024-35, Notice 2024-35.
get-case · Get Court Opinion Retrieve the full text of a U.S. Tax Court opinion by reporter citation or case name, with the court, decision date, docket number, and a precedential-status label. The corpus holds 49,000+ opinions back to 1942. Large opinions are paginated. Appellate history isn't tracked, so confirm an opinion hasn't been reversed or vacated on appeal. Requires Pro+.
Parameters
-
querystring · required · A reporter citation (e.g. 142 T.C. 348) or case name (e.g. Soroban Capital Partners). -
pageinteger · optional · 1-based page to retrieve when an opinion is too large to return in full (default 1).
get-citing-cases · Get Citing Cases Show an opinion's citation graph: how many later Tax Court opinions cite it, and which in-corpus opinions it cites, plus a heuristic flag for possible negative treatment on citing opinions. A signal of influence and currency, not a Shepard's- or KeyCite-style validity check. Requires Pro+.
Parameters
-
querystring · required · A reporter citation or case name to pull the citation history for.
get-cross-references · Get Tax Code Cross-References From a known section, return what it cites and what cites it. Useful for mapping how a provision relates to others.
Parameters
-
sectionstring · required · Source section, e.g. 199A. -
directionstring · optional · inbound, outbound, or both (default).
State coverage
Pro+ includes searchable tax statutes for 41 U.S. jurisdictions. Alaska, Nevada, New Hampshire, South Dakota, Vermont, and West Virginia are the newest additions.
Use the jurisdiction filter as state_{code}, such as state_or for Oregon.
- Alabama AL
- Alaska New AK
- Arizona AZ
- Arkansas AR
- California CA
- Colorado CO
- Connecticut CT
- Delaware DE
- District of Columbia DC
- Florida FL
- Georgia GA
- Idaho ID
- Illinois IL
- Indiana IN
- Iowa IA
- Kentucky KY
- Louisiana LA
- Maine ME
- Maryland MD
- Massachusetts MA
- Michigan MI
- Minnesota MN
- Mississippi MS
- Missouri MO
- Nevada New NV
- New Hampshire New NH
- New York NY
- North Carolina NC
- Ohio OH
- Oregon OR
- Rhode Island RI
- South Carolina SC
- South Dakota New SD
- Tennessee TN
- Texas TX
- Utah UT
- Vermont New VT
- Virginia VA
- Washington WA
- West Virginia New WV
- Wisconsin WI
Plans & limits
Tool access scales with your plan. Tools that aren't available on the current plan return a clear upgrade prompt instead of failing silently.
Free
Internal Revenue Code only, 20 searches per day.
Pro
Unlimited searches. All federal sources: IRC, Treasury Regs, IRS Publications, Revenue Rulings, Revenue Procedures, Notices, cross-references.
Pro+
Everything in Pro, plus Tax Court case law (49,000+ opinions) and state tax codes for the supported states.
Team
Unlimited Pro+ research for every member, plus named users, member roles, team usage visibility, centralized billing, priority support, and team API keys. Three-seat minimum.
Full pricing on the pricing page.
Authentication
TaxMCP implements OAuth 2.0 with Dynamic Client Registration (RFC 7591). The first time a new MCP client connects, it registers itself with our authorization server and is issued a client ID automatically, with no manual configuration needed.
You authorize the client once via your browser by signing in to TaxMCP and approving the requested scope (mcp:use). Tokens are issued to your account and can be revoked anytime from your dashboard.
The server enforces per-plan rate limits on every request.
Troubleshooting
The connector won't connect
Confirm the URL is exactly https://app.taxmcp.io/mcp with no trailing slash. If OAuth fails, retry the sign-in flow in a non-incognito window.
A tool returns an upgrade prompt
Cross-references, IRS publications, and rulings require Pro; Tax Court case law and state codes require Pro+. Upgrade at app.taxmcp.io/billing.
Something else
Email hello@taxmcp.io.