io.github.kodandy/jp-crypto-tax-rules
Machine-readable Japanese crypto-asset tax rules for AI agents: rules-as-code with citations, x402.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http jp-crypto-tax-rules 'https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp'{
"mcpServers": {
"jp-crypto-tax-rules": {
"type": "http",
"url": "https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
JP Crypto Tax Rules — MCP Server
Remote MCP server exposing machine-readable rules-as-code for Japanese crypto-asset taxation to AI agents — structured rules with statutory citations, tax parameters, and the current-vs-2028-reform transition logic. Built from public sources only.
- MCP endpoint (Streamable HTTP, stateless):
https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp - Machine index: llms.txt · API contract: openapi.yaml
- Sibling gateways: jp-m2m-mcp (corporate records) · jp-biz-opportunity-mcp (tenders & subsidies)
Not tax advice. This is general tax-system information served as structured rules with citations. It does not respond to individual circumstances and is not a substitute for advice from a licensed tax professional (税理士). Always verify against primary sources.
| Tool | Pricing | Returns |
|---|---|---|
list_tax_rules | Free | Rule catalog, filterable by category / taxpayer / tax_year (resolves the applicable epoch) |
get_tax_rule | Free | One rule in full: statement, exceptions, statutory citations, sources |
get_tax_parameters | Free | Tax-rate tables and thresholds with sources (income brackets, 20.315% breakdown, filing threshold) |
get_rule_pack | 0.05 USDC (x402) | Scenario-curated bundle: defi_staking, overseas_exchange, corporate_holding, transition_2028 |
The paid tool genuinely fulfills: a settled x402 payment returns the rule pack itself, not a placeholder.
Connect
claude mcp add --transport http jp-crypto-tax https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp{
"mcpServers": {
"jp-crypto-tax": {
"type": "streamable-http",
"url": "https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp"
}
}
}No API key and no initialize handshake required. USDC on Base (testnet during the current private beta).
Scope & sources
- Epochs: current regime (miscellaneous income, total-average / moving-average cost basis, through FY2027 returns) and the FY2026 reform (20.315% separate taxation, 3-year loss carryforward) marked
enacted_pendinguntil the enforcement date is fixed. - Sources: 国税庁 暗号資産FAQ (令和7年12月版), the relevant 所得税法 / 法人税法 / 消費税法 provisions via e-Gov, and the 令和8年度税制改正大綱. Every rule carries its own citations.
- Status: closed private beta. Rules, scope and pricing may change. Source of the gateway lives in a private repository; this repo hosts the public MCP documentation and registry manifest.
License
Frequently asked questions
What is io.github.kodandy/jp-crypto-tax-rules?
Machine-readable Japanese crypto-asset tax rules for AI agents: rules-as-code with citations, x402.
How do I install io.github.kodandy/jp-crypto-tax-rules?
It runs as a remote server. In Claude Code: claude mcp add --transport http jp-crypto-tax-rules 'https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.kodandy/jp-crypto-tax-rules need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.kodandy/jp-crypto-tax-rules open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.kodandy/jp-crypto-tax-rules?
It is published by kodandy. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.