About jp-crypto-tax-rules
jp-crypto-tax-rules is a remote MCP server for AI agents that provides structured rules for Japanese crypto-asset taxation, with citations and parameters. It covers the current regime and the transition to the 2028 reform.
Key features
- 01Filterable tax-rule catalog
- 02Full rules with exceptions and citations
- 03Tax rates and thresholds
- 04Scenario-based rule packs via x402
Use cases
- 01Check rules for a tax year and taxpayer type
- 02Review sourced tax rates and thresholds
- 03Retrieve rules for staking or overseas exchanges
MCP support
Exposes tax-rule and parameter tools to MCP clients over stateless Streamable HTTP. A curated rule-pack tool uses x402 payment.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcpclaude mcp add --transport http kodandy-jp-crypto-tax-rules https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp{"mcpServers":{"kodandy-jp-crypto-tax-rules":{"type":"http","url":"https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp"}}}Open in Cursor{"servers":{"kodandy-jp-crypto-tax-rules":{"type":"http","url":"https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp"}}}Open in VS Code{"mcpServers":{"kodandy-jp-crypto-tax-rules":{"type":"http","url":"https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp"}}}{"mcpServers":{"kodandy-jp-crypto-tax-rules":{"serverUrl":"https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| category | string | No | Category filter: corporate | cost_basis | filing | income_classification | reform_2028 | taxable_events |
| tax_year | integer | No | Tax year to resolve rule applicability, e.g. 2026 or 2028 |
| taxpayer | string | No | Taxpayer filter: all | corporate | individual |
Details
From the project READMEJP 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.