Hive Tax Observer

Hive Tax Observer

针对加密货币交易的观察性税务事件追踪。真实的链上通道。不提供税务建议。不提供报税服务。

Hive 不提供税务建议或报税服务。这里只提供观察性交易数据。请咨询持证税务专业人士，以作出合规决策。

hive-mcp-tax-observer 是一个模型上下文协议（MCP）服务，可将已结算的链上交易归类为四种观察性类型之一——出售、兑换、收入或转账——并提供自有成本基础追踪器所需的相关输入（持有人、资产、金额、交易对手、时间戳）。 通过公共 RPC，真实读取 Base 主网、Ethereum 主网和 Solana 主网数据。

我们不会计算成本基础。我们不会报税。我们不会生成 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	将单个 tx_hash + chain 归类为出售、兑换、收入或转账。返回成本基础相关输入和免责声明。
tax.bulk	在一次调用中归类一组交易哈希（最多 50 个）。返回每笔交易的结果和按类型汇总的信息。
tax.today	按类型汇总过去 24 小时内归类的事件，并提供应税信号小计。免费。

后端端点

方法	路径	用途
POST	/v1/tax/event	单笔交易归类
POST	/v1/tax/bulk	批量交易归类（最多 50 笔）
GET	/v1/tax/today	24 小时汇总
GET	/v1/tax/health	服务运行状态

归类模型

所有归类结果均为观察性，仅根据链上数据得出：

类型	信号
sale	发送方转出资产，且没有相应的流入（可能是资产处置）。
swap	发送方在同一笔交易中既转出又收到资产（类似 DEX 的交易）。
income	发送方收到资产，且没有相应的流出。
transfer	同一受益所有人，且未检测到该地址有应税流入或流出。

当类型为 sale、swap 或 income 时，会将 taxable_signal: true 标记设为 true。 **这不是税务判定。**这是根据 Agent 提供的交易哈希得出的启发式信号。

本地运行

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 结算，以及 Agent 间通道。

类别：金融、税务、合规、web3、Agent 间协作、可观测性。

许可证

MIT (c) Steve Rotzin / Hive Civilization

Hive Civilization Directory

这是 Hive Civilization 的一部分——面向 Agent 的金融基础设施。

• 端点目录：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