Skip to content
MCP server

Taxcode

US federal, state, Puerto Rico and Canada tax statutes with residency calculators

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
1.4.1
Listing updated
today

Similar MCP servers

About Taxcode

Taxcode is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.

Statutes live in a DuckDB store with full-text search and point-in-time versions, so a lookup can ask what a section said in an earlier tax year. The README lists IRC sections and IRS publications, Puerto Rico's Act 60 and Ley 1-2011, all 50 states plus DC, and Canada's Income Tax Act sections in English and French. Long results are paged, and every statutes call is capped at 32,000 characters.

Eight read-only tools split across three mounted sub-servers for system, statutes and compliance. The compliance tools are deterministic: they test Puerto Rico bona fide residency under IRC 937, allocate built-in gains across a move, and count state presence days with domicile risk flags. The README states that none of it is tax or legal advice.

Server profiles (full, system, statutes, compliance, readonly, researcher, advisor) trim the tool set, and a read-only switch restricts execution. It installs from PyPI or a container image and runs over stdio under the Apache-2.0 licence.

Install

Run in a terminal

claude mcp add taxcode --env TAXCODE_API_KEY='<TAXCODE_API_KEY>' -- uvx mcp-server-taxcode

Add to claude_desktop_config.json

{
  "mcpServers": {
    "taxcode": {
      "command": "uvx",
      "args": [
        "mcp-server-taxcode"
      ],
      "env": {
        "TAXCODE_API_KEY": "<TAXCODE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "taxcode": {
      "command": "uvx",
      "args": [
        "mcp-server-taxcode"
      ],
      "env": {
        "TAXCODE_API_KEY": "<TAXCODE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "taxcode": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-taxcode"
      ],
      "env": {
        "TAXCODE_API_KEY": "<TAXCODE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "taxcode": {
      "command": "uvx",
      "args": [
        "mcp-server-taxcode"
      ],
      "env": {
        "TAXCODE_API_KEY": "<TAXCODE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "taxcode": {
      "command": "uvx",
      "args": [
        "mcp-server-taxcode"
      ],
      "env": {
        "TAXCODE_API_KEY": "<TAXCODE_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TAXCODE_API_KEYAPI token for service authentication
  • TAXCODE_BASE_URLOptional REST base URL override
  • TAXCODE_MCP_PROFILEServer profile (full, system, statutes, compliance, readonly, researcher, advisor)
  • TAXCODE_MCP_READONLYRestrict server execution strictly to read-only inspection tools
  • TAXCODE_API_KEYAPI token for service authentication
  • TAXCODE_BASE_URLOptional REST base URL override
  • TAXCODE_MCP_PROFILEServer profile (full, system, statutes, compliance, readonly, researcher, advisor)
  • TAXCODE_MCP_READONLYRestrict server execution strictly to read-only inspection tools

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

system_get_health_status
Reports the server health status.
statutes_lookup_statute
Returns statute text by citation or id, with paging and tax-year filtering.
statutes_search_tax_code
Full-text search over the tax code returning ranked snippets.
statutes_list_publications
Lists indexed publications.
compliance_evaluate_pr_bona_fide_residency
Tests IRC 937 Puerto Rico bona fide residency.
compliance_calculate_built_in_gain_sourcing
Allocates capital gains across pre-move and post-move holding periods.
compliance_evaluate_georgia_residency
Evaluates Georgia residency.
compliance_evaluate_state_residency
Counts presence days and flags domicile risk across states.

What it does

Statute catalogue
Searches federal, Puerto Rico, state, DC and Canadian tax provisions.
Point-in-time lookup
Fetches a section as it read in a given tax year.
Paged responses
Keeps results under 32,000 characters with cursors for long text.
Residency engines
Computes bona fide residency, state presence and built-in gain sourcing.
Canada support
Handles Canadian residency and departure tax estimates, with French text.
Tool profiles
Role-shaped profiles such as researcher and advisor limit exposed tools.

Good for

  • Look up the text of an IRC section for a given year
  • Search statutes across states for a residency question
  • Count days of presence for multi-state residency
  • Estimate gain allocation for a move to Puerto Rico
  • Research Canadian departure tax rules

Pricing

Open source

Taxcode FAQ

Is this tax advice?

No. The README warns it provides models and unofficial summaries for information and research only.

How is it installed?

From PyPI as mcp-server-taxcode or as a container image, over stdio.

Can I make it read-only?

Yes, TAXCODE_MCP_READONLY=1 restricts it to read-only inspection tools.

What licence is it?

Apache-2.0.

Is Taxcode free?

Yes. Taxcode is open source, so you can use and self-host it for free.

How do I add Taxcode to Claude Code?

Run this command in your terminal: claude mcp add taxcode --env TAXCODE_API_KEY='<TAXCODE_API_KEY>' -- uvx mcp-server-taxcode

What are the best alternatives to Taxcode?

The closest alternatives to Taxcode are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Data Ny and Crypto Feeds.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers