# Taxcode

> Taxcode is an open-source MCP server for legal and government. US federal, state, Puerto Rico and Canada tax statutes with residency calculators. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/christianclaudio/mcp-server-taxcode
- **MCP Registry name:** io.github.christianclaudio/taxcode
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Data Ny](https://ai-powered.com/mcp/data-ny): Data Ny is a freemium MCP server for legal and government.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Datos Gob Es](https://ai-powered.com/mcp/datos-gob-es): Datos Gob Es is a freemium MCP server for legal and government.
- [Datos Cl](https://ai-powered.com/mcp/datos-cl): Datos Cl is a freemium MCP server for legal and government.
- [Cipo](https://ai-powered.com/mcp/cipo): Cipo is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/taxcode
