CLI

The OpenZac CLI lets you query sales tax allocation data from your terminal. To connect an AI assistant such as Claude, Codex, or Gemini, use the OpenZac MCP server.

Installation

Requires Node.js >= 20.

npm install -g @zactax/openzac

To update to the latest version:

npm update -g @zactax/openzac

Authentication

Sign up for a free API key at open.zactax.com, then log in:

openzac login

You'll be prompted to enter your API key via masked input. On macOS, your key is stored securely in the system keychain. On other platforms, it's stored at ~/.config/openzac/settings.json with restricted permissions.

To remove your stored API key:

openzac logout

CLI Usage

For full CLI usage and command reference, see the package documentation on npm.

MCP server removed

The CLI no longer includes an MCP server. The openzac mcp and openzac agents commands have been removed.

Use the remote OpenZac MCP server instead. It works with the same assistants and needs nothing installed.

If you set up the old MCP server, remove the openzac entry from each assistant, then add the remote server:

  • Claude Code: claude mcp remove openzac
  • Claude Desktop: delete the openzac entry from mcpServers in claude_desktop_config.json
  • Codex CLI: delete the [mcp_servers.openzac] section from ~/.codex/config.toml
  • Gemini CLI: delete the openzac entry from mcpServers in ~/.gemini/settings.json

See the package documentation on npm for more details.