{"_id":"@boomtax/mcp-server","name":"@boomtax/mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@boomtax/mcp-server","version":"1.0.0","description":"MCP server for querying BoomTax filing data through AI assistants","type":"module","main":"index.js","bin":{"boomtax-mcp":"index.js"},"engines":{"node":">=18"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/boomtax/mcp-server.git"},"author":{"name":"BoomTax","email":"support@boomtax.com"},"homepage":"https://www.boomtax.com","keywords":["mcp","boomtax","tax","1099","w2","e-file","model-context-protocol"],"dependencies":{"@modelcontextprotocol/sdk":"^1.10.0","zod":"^3.23.0"},"_id":"@boomtax/mcp-server@1.0.0","gitHead":"4b02cd7660f13ccde56034921eae78981d2391ea","bugs":{"url":"https://github.com/boomtax/mcp-server/issues"},"_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-CKt1ZZ7FtU5bAy7RJUuvlO7qxjy9wy29caFfv3MyFPOq5hQgmIJ/uBePZieHF3EtBUdTLqdGgcHGZhLWhH/gNg==","shasum":"50961c1ae97abb03a9bf297ff03941bc174ef9c0","tarball":"https://registry.npmjs.org/@boomtax/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":4,"unpackedSize":22768,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHV1VUKSycwqK1JMMgd8npmRpkrE8yrI0ErUqZf5aHS0AiBf0pRD9mcaF2m4sVUibQ9wexQhcFqkBw+4RqDLX6DVRg=="}]},"_npmUser":{"name":"boomtax_","email":"dev@boomtax.com"},"directories":{},"maintainers":[{"name":"boomtax_","email":"dev@boomtax.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.0_1775255172289_0.5057298353654651"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-03T22:26:12.117Z","1.0.0":"2026-04-03T22:26:12.466Z","modified":"2026-04-03T22:26:12.691Z"},"maintainers":[{"name":"boomtax_","email":"dev@boomtax.com"}],"description":"MCP server for querying BoomTax filing data through AI assistants","homepage":"https://www.boomtax.com","keywords":["mcp","boomtax","tax","1099","w2","e-file","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/boomtax/mcp-server.git"},"author":{"name":"BoomTax","email":"support@boomtax.com"},"bugs":{"url":"https://github.com/boomtax/mcp-server/issues"},"license":"MIT","readme":"# BoomTax MCP Server\n\nQuery your BoomTax tax filing data from any AI assistant that supports the [Model Context Protocol](https://modelcontextprotocol.io) — Claude, Cursor, Windsurf, VS Code Copilot, and more.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_filings` | List filings with filters (tax year, form type, status) |\n| `get_filing_details` | Filing detail with payer summary and e-file status |\n| `get_filing_summary` | Aggregate counts by status and form type |\n| `list_filing_forms` | List forms in a filing |\n| `get_form` | Form metadata (type, status, dates) |\n| `get_efile_status` | E-file request/response timeline |\n| `get_efile_errors` | E-file errors with codes and messages |\n| `list_payers` | List payers across filings |\n| `get_payer` | Payer details for a filing |\n| `list_filing_types` | All supported filing types and e-file availability |\n\nAll tools are read-only. TINs are always masked (last 4 digits only).\n\n## Prerequisites\n\nYour BoomTax account must have API access enabled. Contact [support@boomtax.com](mailto:support@boomtax.com) to request access.\n\n## Setup\n\n### Option A: Remote (recommended)\n\nConnect directly to BoomTax — no install required. Requires a BoomTax API token.\n\n### Option B: Local (npx)\n\n```\nnpx @boomtax/mcp-server\n```\n\nRequires environment variables:\n- `BOOMTAX_API_USERNAME` — your BoomTax email\n- `BOOMTAX_API_PASSWORD` — your BoomTax password\n- `BOOMTAX_API_URL` — (optional) defaults to `https://api.boomtax.com`\n\n---\n\n## Configuration by AI Client\n\n### Claude Desktop\n\n**Remote:**\n```json\n{\n  \"mcpServers\": {\n    \"boomtax\": {\n      \"url\": \"https://api.boomtax.com/mcp\"\n    }\n  }\n}\n```\n\n**Local:**\n```json\n{\n  \"mcpServers\": {\n    \"boomtax\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boomtax/mcp-server\"],\n      \"env\": {\n        \"BOOMTAX_API_URL\": \"https://api.boomtax.com\",\n        \"BOOMTAX_API_USERNAME\": \"you@yourfirm.com\",\n        \"BOOMTAX_API_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add boomtax --transport http https://api.boomtax.com/mcp\n```\n\nOr local:\n```bash\nclaude mcp add boomtax -- npx @boomtax/mcp-server\n```\n\n### Cursor\n\nAdd to Cursor Settings > MCP Servers:\n\n**Remote:**\n```json\n{\n  \"mcpServers\": {\n    \"boomtax\": {\n      \"url\": \"https://api.boomtax.com/mcp\"\n    }\n  }\n}\n```\n\n**Local:**\n```json\n{\n  \"mcpServers\": {\n    \"boomtax\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boomtax/mcp-server\"],\n      \"env\": {\n        \"BOOMTAX_API_URL\": \"https://api.boomtax.com\",\n        \"BOOMTAX_API_USERNAME\": \"you@yourfirm.com\",\n        \"BOOMTAX_API_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"boomtax\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boomtax/mcp-server\"],\n      \"env\": {\n        \"BOOMTAX_API_URL\": \"https://api.boomtax.com\",\n        \"BOOMTAX_API_USERNAME\": \"you@yourfirm.com\",\n        \"BOOMTAX_API_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot)\n\nAdd to `.vscode/mcp.json` in your project:\n\n```json\n{\n  \"servers\": {\n    \"boomtax\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boomtax/mcp-server\"],\n      \"env\": {\n        \"BOOMTAX_API_URL\": \"https://api.boomtax.com\",\n        \"BOOMTAX_API_USERNAME\": \"${input:boomtaxUsername}\",\n        \"BOOMTAX_API_PASSWORD\": \"${input:boomtaxPassword}\"\n      }\n    }\n  },\n  \"inputs\": [\n    {\n      \"id\": \"boomtaxUsername\",\n      \"type\": \"promptString\",\n      \"description\": \"BoomTax API username (email)\",\n      \"password\": false\n    },\n    {\n      \"id\": \"boomtaxPassword\",\n      \"type\": \"promptString\",\n      \"description\": \"BoomTax API password\",\n      \"password\": true\n    }\n  ]\n}\n```\n\n---\n\n## Example Prompts\n\nOnce connected, try asking your AI assistant:\n\n- \"What filings do I have for tax year 2025?\"\n- \"Show me a summary of all my filings\"\n- \"What's the e-file status of my W-2 filing?\"\n- \"Are there any e-file errors on my 1099-NEC filing?\"\n- \"List all my payers\"\n- \"What filing types does BoomTax support?\"\n\n## Security\n\n- All data access is scoped to your authenticated account\n- TINs/SSNs are always masked (last 4 digits only)\n- All tools are read-only — no data can be modified\n- The local server authenticates via the same JWT tokens as the REST API\n- API access requires explicit opt-in on your BoomTax account\n\n## License\n\nProprietary. Copyright BoomTax.\n","readmeFilename":"README.md","_rev":"1-7dbddacceb48be7faf5ce0c2bce23cd6"}