mcp-server-taxcode 0.5.0__tar.gz → 0.6.0__tar.gz

{mcp_server_taxcode-0.5.0 → mcp_server_taxcode-0.6.0}/.github/workflows/ci.yml

@@ -5,12 +5,12 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
-  # Merges made by dependabot-automerge.yml use GITHUB_TOKEN, and events caused
-  # by GITHUB_TOKEN never start new workflow runs, so the push trigger above
+  # Merges made by dependabot-automerge.yml use GITHUB_TOKEN, and pushes made
+  # with GITHUB_TOKEN don't trigger push workflows, so the push trigger above
   # misses them. The daily run tests main itself; schedule runs only on the
   # default branch. The minute is off the hour to avoid peak scheduler load.
   schedule:
-    - cron: '17 9 * * *'
+    - cron: '29 9 * * *'
   workflow_dispatch:
 
 concurrency:

{mcp_server_taxcode-0.5.0 → mcp_server_taxcode-0.6.0}/AGENTS.md

@@ -47,7 +47,7 @@ Host configuration JSON for these doc servers (`mcp_config.json` and other deskt
 - `scripts/check_tool_contract.py` — source of truth for the expected tool set and annotations. Do not hard-code tool counts elsewhere.
 - `scripts/check_openapi_drift.py`, `scripts/check_conformance.sh` + `conformance-baseline.yml` — drift and protocol conformance.
 - `tests/` — offline unit, layered-composition, and protocol tests; `test_e2e_live.py` is opt-in (`-m e2e`).
-- `.github/workflows/` — `ci.yml`, `drift-monitor.yml`, `dependabot-automerge.yml`, and `release.yml` (on a `v*` tag: build with full history, check the wheel version matches the tag, create the GitHub Release from `scripts/release_notes.py`; then `docker` builds the image and pushes it to GHCR (`contents: read`, `packages: write`), `attest` attests the pushed digest (`contents: read`, `id-token: write`, `attestations: write`), and `registry` publishes `server.json` to the MCP Registry last (`contents: read`, `id-token: write`). In `christianclaudio/mcp-server-taxcode` the image is built but `docker` does not push and `attest` and `registry` skip; no PyPI publish). `ci.yml`'s `docker-build` job builds the image on every PR and checks its `io.modelcontextprotocol.server.name` label matches `server.json`. Product repos copy this `release.yml` and add their PyPI publish job to `registry`'s `needs:` (COOKBOOK Recipe 6).
+- `.github/workflows/` — `ci.yml`, `drift-monitor.yml`, `dependabot-automerge.yml`, and `release.yml` (on a `v*` tag: build with full history, verify the wheel version matches the tag, publish to PyPI via OIDC, create the GitHub Release from `scripts/release_notes.py`, build and push the container image to GHCR, attest build provenance for both wheel and container digests, and publish `server.json` to the MCP Registry). `ci.yml`'s `docker-build` job builds the image on every PR and checks its `io.modelcontextprotocol.server.name` label matches `server.json`.
 - `scripts/release_notes.py` — release body from squash commits since the previous `v*` tag. `scripts/check_version.py` — runs after `uv build` and reads the version from the single wheel in `dist/` (the file that ships, as release.yml's tag check does); fails on `0.0.0` (no git metadata) or `0.0.1.devN` (no reachable tag, a shallow checkout).
 - `server.json` (MCP Registry metadata), `Dockerfile`, `pyproject.toml`, `fastmcp.json`.
 - `COOKBOOK.md` — private maintainer runbook (release SOP, drift, testing, composition, payload hardening, naming recipes). Template-only.
@@ -199,6 +199,6 @@ coderabbit review --agent --uncommitted
 
 ## 🔄 CI & Releases
 
-CI is defined in `.github/workflows/ci.yml` (jobs: `lint-and-types`, `test` on Python 3.10–3.13, `tool-contract`, `build-check`, `docker-build` (builds the image without pushing and checks its MCP server-name label against `server.json`)). It runs on pushes and pull requests to `main`, daily on `main` at 09:17 UTC (`schedule`), and on manual dispatch (`workflow_dispatch`); the daily run exists because merges by `dependabot-automerge.yml` use `GITHUB_TOKEN` and so never trigger the `push` run. Run the commands above before opening a PR. Scheduled upstream drift runs in `drift-monitor.yml`. `dependabot-automerge.yml` turns on squash auto-merge only for Dependabot PRs whose highest update is minor or patch; major updates wait for a human review.
+CI is defined in `.github/workflows/ci.yml` (jobs: `lint-and-types`, `test` on Python 3.10–3.13, `tool-contract`, `build-check`, `docker-build` (builds the image without pushing and checks its MCP server-name label against `server.json`)). It runs on pushes and pull requests to `main`, daily on `main` at 09:29 UTC (`schedule`), and on manual dispatch (`workflow_dispatch`); the daily run exists because merges by `dependabot-automerge.yml` use `GITHUB_TOKEN`, and pushes made with `GITHUB_TOKEN` don't trigger push workflows, so those merges get no `push` run. Run the commands above before opening a PR. Scheduled upstream drift runs in `drift-monitor.yml`. `dependabot-automerge.yml` turns on squash auto-merge only for Dependabot PRs whose highest update is minor or patch; major updates wait for a human review.
 
 `release.yml` runs on `v*` tag pushes only: it creates the GitHub Release, then builds the container image, pushes it to GHCR, attests it, and publishes to the MCP Registry. In the template repo the image is built only (no push), and the attest and registry jobs skip. Release procedure (tag-based versioning, release notes, pre-tag checks): **`COOKBOOK.md`** Recipes 1–2; product-repo migration steps: Recipe 9.

{mcp_server_taxcode-0.5.0 → mcp_server_taxcode-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcp-server-taxcode
-Version: 0.5.0
+Version: 0.6.0
 Summary: Enterprise Model Context Protocol (MCP) server for Tax Code
 Project-URL: Homepage, https://github.com/christianclaudio/mcp-server-taxcode
 Project-URL: Documentation, https://github.com/christianclaudio/mcp-server-taxcode#readme
@@ -137,7 +137,7 @@ TAXCODE_MCP_AUTH_TOKEN="$(openssl rand -hex 32)" \
 The image's default command is stdio, so it works as a stdio server out of the box:
 
 ```bash
-docker run -i --rm -e TAXCODE_API_KEY=your-api-key ghcr.io/christianclaudio/<name>
+docker run -i --rm -e TAXCODE_API_KEY=your-api-key ghcr.io/christianclaudio/mcp-server-taxcode:latest
 ```
 
 To serve Streamable HTTP from the container, bind `0.0.0.0` inside it and pass a token:
@@ -146,7 +146,7 @@ To serve Streamable HTTP from the container, bind `0.0.0.0` inside it and pass a
 docker run --rm -p 8000:8000 \
   -e TAXCODE_API_KEY=your-api-key \
   -e TAXCODE_MCP_AUTH_TOKEN=your-long-random-token \
-  ghcr.io/christianclaudio/<name> \
+  ghcr.io/christianclaudio/mcp-server-taxcode:latest \
   --transport streamable-http --host 0.0.0.0 --port 8000 --allowed-host mcp.example.com
 ```
 
@@ -157,22 +157,31 @@ docker run --rm -p 8000:8000 \
 
 This server works out-of-the-box with all major AI assistants, IDEs, and CLI tools via standard `stdio` or `streamable-http`.
 
-The template is not published to PyPI, so these configs run its `taxcode-mcp` console script from a local clone with `uv run --directory`. Replace `/absolute/path/to/mcp-server-taxcode` with the path of your clone. After `uv tool install .` (or `pip install .`) puts both console scripts, `taxcode-mcp` and `mcp-server-taxcode` (the same server), on your `PATH`, `"command": "taxcode-mcp"` with no `args` works too.
+The server is published on PyPI as [`mcp-server-taxcode`](https://pypi.org/project/mcp-server-taxcode/), so you can run it directly with `uvx mcp-server-taxcode` without cloning or manually managing environments. Alternatively, run from a local clone with `uv run --directory /path/to/mcp-server-taxcode taxcode-mcp`.
 
 <details open>
 <summary><b>🧡 Claude Desktop & Claude Code</b></summary>
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
+```json
+{
+  "mcpServers": {
+    "taxcode": {
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
+    }
+  }
+}
+```
+
+For local development from a clone:
 ```json
 {
   "mcpServers": {
     "taxcode": {
       "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"],
-      "env": {
-        "TAXCODE_API_KEY": "your-api-key"
-      }
+      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
     }
   }
 }
@@ -180,7 +189,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 
 For **Claude Code CLI**:
 ```bash
-claude mcp add taxcode -- uv run --directory /absolute/path/to/mcp-server-taxcode taxcode-mcp
+claude mcp add taxcode -- uvx mcp-server-taxcode
 ```
 </details>
 
@@ -193,11 +202,8 @@ Add to `.agents/mcp_config.json` (or global `~/.gemini/config/mcp_config.json`):
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"],
-      "env": {
-        "TAXCODE_API_KEY": "your-api-key"
-      }
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }
@@ -213,8 +219,8 @@ Add to `~/.snowflake/cortex/mcp.json`:
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }
@@ -230,8 +236,8 @@ Add to `~/.cursor/mcp.json`:
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }
@@ -247,8 +253,8 @@ Add to `cline_mcp_settings.json`:
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }

{mcp_server_taxcode-0.5.0 → mcp_server_taxcode-0.6.0}/README.md

@@ -94,7 +94,7 @@ TAXCODE_MCP_AUTH_TOKEN="$(openssl rand -hex 32)" \
 The image's default command is stdio, so it works as a stdio server out of the box:
 
 ```bash
-docker run -i --rm -e TAXCODE_API_KEY=your-api-key ghcr.io/christianclaudio/<name>
+docker run -i --rm -e TAXCODE_API_KEY=your-api-key ghcr.io/christianclaudio/mcp-server-taxcode:latest
 ```
 
 To serve Streamable HTTP from the container, bind `0.0.0.0` inside it and pass a token:
@@ -103,7 +103,7 @@ To serve Streamable HTTP from the container, bind `0.0.0.0` inside it and pass a
 docker run --rm -p 8000:8000 \
   -e TAXCODE_API_KEY=your-api-key \
   -e TAXCODE_MCP_AUTH_TOKEN=your-long-random-token \
-  ghcr.io/christianclaudio/<name> \
+  ghcr.io/christianclaudio/mcp-server-taxcode:latest \
   --transport streamable-http --host 0.0.0.0 --port 8000 --allowed-host mcp.example.com
 ```
 
@@ -114,22 +114,31 @@ docker run --rm -p 8000:8000 \
 
 This server works out-of-the-box with all major AI assistants, IDEs, and CLI tools via standard `stdio` or `streamable-http`.
 
-The template is not published to PyPI, so these configs run its `taxcode-mcp` console script from a local clone with `uv run --directory`. Replace `/absolute/path/to/mcp-server-taxcode` with the path of your clone. After `uv tool install .` (or `pip install .`) puts both console scripts, `taxcode-mcp` and `mcp-server-taxcode` (the same server), on your `PATH`, `"command": "taxcode-mcp"` with no `args` works too.
+The server is published on PyPI as [`mcp-server-taxcode`](https://pypi.org/project/mcp-server-taxcode/), so you can run it directly with `uvx mcp-server-taxcode` without cloning or manually managing environments. Alternatively, run from a local clone with `uv run --directory /path/to/mcp-server-taxcode taxcode-mcp`.
 
 <details open>
 <summary><b>🧡 Claude Desktop & Claude Code</b></summary>
 
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
+```json
+{
+  "mcpServers": {
+    "taxcode": {
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
+    }
+  }
+}
+```
+
+For local development from a clone:
 ```json
 {
   "mcpServers": {
     "taxcode": {
       "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"],
-      "env": {
-        "TAXCODE_API_KEY": "your-api-key"
-      }
+      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
     }
   }
 }
@@ -137,7 +146,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 
 For **Claude Code CLI**:
 ```bash
-claude mcp add taxcode -- uv run --directory /absolute/path/to/mcp-server-taxcode taxcode-mcp
+claude mcp add taxcode -- uvx mcp-server-taxcode
 ```
 </details>
 
@@ -150,11 +159,8 @@ Add to `.agents/mcp_config.json` (or global `~/.gemini/config/mcp_config.json`):
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"],
-      "env": {
-        "TAXCODE_API_KEY": "your-api-key"
-      }
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }
@@ -170,8 +176,8 @@ Add to `~/.snowflake/cortex/mcp.json`:
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }
@@ -187,8 +193,8 @@ Add to `~/.cursor/mcp.json`:
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }
@@ -204,8 +210,8 @@ Add to `cline_mcp_settings.json`:
 {
   "mcpServers": {
     "taxcode": {
-      "command": "uv",
-      "args": ["run", "--directory", "/absolute/path/to/mcp-server-taxcode", "taxcode-mcp"]
+      "command": "uvx",
+      "args": ["mcp-server-taxcode"]
     }
   }
 }

{mcp_server_taxcode-0.5.0 → mcp_server_taxcode-0.6.0}/docs/llms-full.txt

@@ -1,4 +1,4 @@
-# Full Statutory Corpus: US, Puerto Rico & Georgia Tax Intelligence
+# Full Statutory Corpus: US Federal, Puerto Rico & Multi-State Tax Intelligence
 
 ## 26 U.S.C. § 933: Income from sources within Puerto Rico
 `Title 26 > Subtitle A > Chapter 1 > Subchapter N > Part III > Subpart D > § 933`

{mcp_server_taxcode-0.5.0 → mcp_server_taxcode-0.6.0}/docs/llms.txt

@@ -1,7 +1,7 @@
 # TaxCode MCP Intelligence Corpus
 
 > Authoritative statutory and regulatory references for United States Federal Tax Law,
-> Puerto Rico Territorial Tax Law (Act 60-2019 and Ley 1-2011), and Georgia State Tax Law (O.C.G.A. Title 48).
+> Puerto Rico Territorial Tax Law (Act 60-2019 and Ley 1-2011), and all 50 US States + District of Columbia.
 
 ## Statutory Catalog
 
@@ -112,7 +112,7 @@
 - [Wis. Stat. § 71.06 (2024) — Rates of Tax - Individuals](./wi/wis. stat._71_06.md): Wis. Stat. > Chapter 71 > Subchapter I > § 71.06
 - [Wyo. Const. art. 15, § 18 (1974) — Full Tax Credit Requirement for Any Individual Income Tax](./wy/wyo. const._art__15,_§_18.md): Wyo. Const. > Article 15 > § 18
 
-## Administrative Publications (Hacienda SURI & Georgia DOR)
+## Administrative Publications & Guidance
 
 - **CC RI 21-10** (2021-03-31) — Tratamiento contributivo del teletrabajo y servicios prestados por no residentes: Directrices oficiales del Departamento de Hacienda sobre la fuente de ingresos por servicios laborales remotos, retención en el origen y establecimiento permanente en Puerto Rico.
 - **PA REV-BULL 2021-01** (2021-06-15) — Pennsylvania Personal Income Tax Telework and Sourcing Guidance: Guidance from the Pennsylvania Department of Revenue concerning the convenience of the employer doctrine and withholding obligations for telecommuting employees.