Hive Tax Observer

Hive Tax Observer

暗号資産取引における税務イベントを観測して追跡します。実際のオンチェーン基盤を使用します。税務アドバイスではありません。税務申告ではありません。

Hive は税務アドバイスや申告サービスを提供していません。これは観測された取引データのみです。コンプライアンスに関する判断については、資格を持つ税務専門家にご相談ください。

hive-mcp-tax-observer は、確定済みのオンチェーン取引を、売却、スワップ、収入、送金の4種類の観測上の区分に分類し、ご利用の取得原価トラッカーに必要な、取得原価に関連する入力項目（保有者、資産、数量、取引相手、タイムスタンプ）を提示する Model Context Protocol（MCP）サーバーです。 Base メインネット、Ethereum メインネット、Solana メインネットに対して、パブリック RPC 経由で実際に読み取りを行います。

取得原価の計算は行いません。税務申告は行いません。1099 や税務書類の作成も行いません。 ヘルスチェック、エラー、一括レスポンスを含むすべてのレスポンスに、観測に関する免責事項が含まれます。

---

これは何か

• プロトコル： Streamable-HTTP / JSON-RPC 2.0 上の MCP 2024-11-05
• トランスポート： POST /mcp
• 検出： GET /.well-known/mcp.json
• ヘルスチェック： GET /health（200、ブランドカラー、免責事項、有効化状況、対応チェーン）
• バックエンド： https://hivemorph.onrender.com — /v1/tax/*
• ブランド： Hive Civilization ゴールド #C08D23（Pantone 1245 C）

ツール

ツール	説明
tax.classify	1つの tx_hash と chain を、売却、スワップ、収入、送金に分類します。取得原価に関連する入力項目と免責事項を返します。
tax.bulk	tx ハッシュの配列（最大50件）を1回の呼び出しで分類します。各 tx の結果と区分別の概要を返します。
tax.today	区分ごとに分類したイベントを24時間分集計し、課税シグナルの小計を表示します。無料です。

バックエンドのエンドポイント

メソッド	パス	目的
POST	/v1/tax/event	単一 tx の分類
POST	/v1/tax/bulk	tx の一括分類（最大50件）
GET	/v1/tax/today	24時間分の集計
GET	/v1/tax/health	サービスの稼働状況

分類モデル

すべての分類は観測上のものであり、オンチェーンデータのみから導出されます。

区分	シグナル
sale	送信者が資産を送出し、相殺する流入がありません（処分である可能性があります）。
swap	同じ tx 内で送信者が資産を送出し、資産を受け取っています（DEX 形式）。
income	送信者が資産を受け取り、相殺する流出がありません。
transfer	同一の実質的所有者であり、このアドレスから課税対象となる流入または流出は検出されていません。

区分が sale、swap、income のいずれかの場合、taxable_signal: true フラグが設定されます。 これは税務上の判定ではありません。 エージェントから提供された tx ハッシュに基づくヒューリスティックなシグナルです。

ローカルで実行する

git clone https://github.com/srotzin/hive-mcp-tax-observer.git
cd hive-mcp-tax-observer
npm install
npm start
# server up on http://localhost:3000/mcp
curl http://localhost:3000/health
curl http://localhost:3000/.well-known/mcp.json

MCP クライアントから接続する

Claude Desktop / Cursor / Manus — mcp.json に追加します。

{
  "mcpServers": {
    "tax_observer": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://hive-mcp-tax-observer.onrender.com/mcp"]
    }
  }
}

クイックスタート

# Classify a single Base transaction
curl -sX POST https://hive-mcp-tax-observer.onrender.com/v1/tax/event \
  -H 'content-type: application/json' \
  -d '{"tx_hash":"0x...","chain":"base"}' | jq

# 24h rollup (free)
curl -s https://hive-mcp-tax-observer.onrender.com/v1/tax/today | jq

# Bulk
curl -sX POST https://hive-mcp-tax-observer.onrender.com/v1/tax/bulk \
  -H 'content-type: application/json' \
  -d '{"chain":"base","tx_hashes":["0x...","0x..."]}' | jq

対応していないこと

• 取得原価の計算は行いません。取得原価トラッカーに必要な入力項目を提示します。
• 税務申告、1099 の作成、税務書類の作成は行いません。
• コンプライアンスに関する判定は行いません。
• 税務アドバイスは提供しません。資格を持つ税務専門家にご相談ください。

Hive Civilization

Hive Civilization の一部です — 主権型 DID、USDC 決済、エージェント間の基盤。

カテゴリ：金融、税務、コンプライアンス、Web3、エージェント間、可観測性。

ライセンス

MIT (c) Steve Rotzin / Hive Civilization

Hive Civilization ディレクトリ

Hive Civilization の一部です — エージェントネイティブな金融インフラストラクチャです。

• エンドポイントディレクトリ：https://thehiveryiq.com
• ライブリーダーボード：https://hive-a2amev.onrender.com/leaderboard
• 収益ダッシュボード：https://hivemine-dashboard.onrender.com
• その他の MCP サーバー：https://github.com/srotzin?tab=repositories&q=hive-mcp

ブランド：#C08D23