Documentation

Connect taxmcp.io to your AI client

One URL, OAuth sign-in, then ask any tax question. Below: setup for the major clients, the five tools the server exposes, and example prompts with what each returns.

Setup

The server URL is the same for every client. Pick yours.

Server URL
https://app.taxmcp.io/mcp

Claude (Desktop & Web)

  1. Open Claude and go to Settings.
  2. Navigate to Customize → Connectors.
  3. Click the + button, then Add custom connector.
  4. In the Name field, type TaxMCP.
  5. Paste https://app.taxmcp.io/mcp into the URL field.
  6. Click Add, then sign in when prompted to authorize the connection (free tier — no credit card). The five tools become available in any conversation.

ChatGPT

  1. Open Settings → Connectors.
  2. Click Add MCP server.
  3. Paste https://app.taxmcp.io/mcp as the URL.
  4. Sign in via OAuth and approve.

Other MCP clients

taxmcp.io is a standard remote MCP server over streamable HTTP with OAuth 2.0 (RFC 7591 Dynamic Client Registration). Any compliant client works — Cursor, Windsurf, Continue, Claude Code, custom clients built on the MCP SDKs.

Configure your client with server URL https://app.taxmcp.io/mcp. The client will self-register, then prompt you to authorize via your browser.

Example prompts

What to type, which tool fires, and what the model gets back to ground its answer.

Prompt 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.

Prompt 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.

Prompt 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.

Prompt 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.

Prompt 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 five 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, and Revenue Rulings. Returns ranked excerpts with section identifiers and citation URLs.

Parameters

  • query string · required — The natural-language question or keyword phrase.
  • jurisdiction string · optional — Restrict to a state (e.g. state_ga for Georgia). Requires Pro+.
  • source_type string · optional — Restrict by source: irc, treasury_reg, publication, revenue_ruling, notice, state_tax_code.
  • limit integer · 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. Returns the full statutory text with citation URL.

Parameters

  • section string · required — Section identifier, e.g. 199A, 1.280A-2, or AL-40-18-1 for state codes.
  • source_type string · optional — Disambiguate when an identifier is ambiguous.
  • include_refs boolean · 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

  • number string · required — Publication number, e.g. 946, 334, 17.
  • section string · 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.

Parameters

  • identifier string · required — e.g. Rev. Rul. 2024-01, Rev. Proc. 2024-35, Notice 2024-35.
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

  • section string · required — Source section, e.g. 199A.
  • direction string · optional — inbound, outbound, or both (default).

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 queries per day.

Pro

Unlimited queries. All federal sources: IRC, Treasury Regs, IRS Publications, Revenue Rulings, Notices, cross-references.

Pro+

Everything in Pro plus state tax codes for the supported states.

Full pricing on the pricing page.

Authentication

taxmcp.io 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 — no manual configuration needed.

You authorize the client once via your browser by signing in to taxmcp.io 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, rulings, and state codes require Pro or Pro+. Upgrade at app.taxmcp.io/billing.

Something else

Email hello@taxmcp.io.