# JP Crypto Tax Rules Gateway (Closed Private Beta)

> Machine-readable rules-as-code for Japanese crypto-asset taxation: structured rules with statutory citations, tax parameters, and the current-vs-2028-reform transition logic, built for autonomous agents from public sources only.

Rules-as-code: every rule carries its statutory citations (sources), and the
corpus is built from public sources only (NTA crypto-asset tax FAQ, e-Gov
statute texts, MOF tax-reform documents). This gateway provides general
tax-system information. It is NOT tax advice (税務助言ではない); every response
carries the disclaimer 「一般的な税制情報の提供であり、個別の税務判断は税理士にご相談ください。」
公開情報のみ（公開法令・公表FAQ・公表大綱）を構造化した rules-as-code です。

Rule and parameter endpoints are free. Scenario packs are metered with the
x402 protocol (HTTP 402 + X-402-Payment-Required header, 0.05 USDC per call);
a successful settlement delivers the pack body in the 200 response.

## Interface
- https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/openapi.yaml : OpenAPI 3.0.3 contract (paths, schemas, x402 flow)
- https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/sitemap.xml  : indexable JSON-LD dataset metadata pages

## MCP (Model Context Protocol)
- https://jp-crypto-tax-rules-62ko7b2uwa-an.a.run.app/mcp : remote MCP server (Streamable HTTP, stateless). Tools:
  list_tax_rules (free), get_tax_rule (free), get_tax_parameters (free),
  get_rule_pack (x402-metered; settlement delivers the pack body).

## Free data endpoints
- /v1/rules?category=&taxpayer=&tax_year= : structured rule summaries with citations; tax_year resolves the current-vs-2028-reform epoch per rule (applies / pending_enforcement)
- /v1/rules/{rule_id} : full rule record (statement, exceptions, effective dates, sources)
- /v1/parameters : tax parameters (progressive brackets, rates, thresholds) with sources

## Paid data endpoints (x402)
- /v1/packs/{scenario} : curated rule pack; scenario = defi_staking | overseas_exchange | corporate_holding | transition_2028