Hive Tax Observer

io.github.srotzin由 GitHub 账号 srotzin 发布v1.0.0更新于 Oct 24, 2026

Read-only tax event observation for agent-to-agent transaction streams

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

只读的 MCP 服务器，将 Base、以太坊和 Solana 上已结算的加密交易归类为卖出、兑换、收入或转账，并返回成本基础所需输入。

可以做什么
  • 按交易哈希和链对单笔交易分类为卖出、兑换、收入或转账，返回持有者、资产、数量、对手方和时间戳。
  • 一次批量调用最多分类 50 个交易哈希，并给出按类别汇总。
  • 获取按类别统计的 24 小时事件汇总及应税信号小计。
  • 查询服务健康状态与支持的链。
适用场景
适合需要把链上加密交易粗略归入事件类别，并收集供独立成本基础工具或税务专业人士使用的原始输入的场景。它只做观察性判断，适用于记账准备和监控，而非合规决策。
运行要求
使用提供方的远程 Streamable-HTTP 端点（POST /mcp）；未声明认证、环境变量或请求头。本地运行需要 Node.js 和 npm。通过公共 RPC 读取 Base、以太坊和 Solana 主网。
安装前请注意
结果仅是基于链上数据的启发式信号，不构成税务建议、成本基础计算、申报或合规判定；README 多次提示应咨询持牌税务专业人士。交易哈希和链名会发送到提供方后端服务。虽然不要求任何凭据，但托管端点为第三方基础设施。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hive Tax Observer，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-tax-observer/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "hive-tax-observer": {
      "type": "http",
      "url": "https://hive-mcp-tax-observer.onrender.com/mcp"
    }
  }
}

README

Hive Tax Observer

[srotzin/hive-mcp-tax-observer MCP server]

Observational tax-event tracking for crypto transactions. Real on-chain rails. Not tax advice. Not tax filing.

Hive does not provide tax advice or filing services. This is observational transaction data only. Consult a licensed tax professional for compliance decisions.

hive-mcp-tax-observer is a Model Context Protocol (MCP) server that classifies a settled on-chain transaction into one of four observational kinds — sale, swap, income, or transfer — and surfaces the cost-basis-relevant inputs (holder, asset, amount, counterparty, timestamp) your own basis tracker needs. Real reads against Base mainnet, Ethereum mainnet, and Solana mainnet via public RPC.

We do not compute cost basis. We do not file taxes. We do not generate 1099s or any tax forms. Every response — including health, errors, and bulk responses — carries the observational disclaimer.

What this is

  • Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
  • Transport: POST /mcp
  • Discovery: GET /.well-known/mcp.json
  • Health: GET /health (200, brand_color, disclaimer, enabled, supported_chains)
  • Backend: https://hivemorph.onrender.com — /v1/tax/*
  • Brand: Hive Civilization gold #C08D23 (Pantone 1245 C)

Tools

ToolDescription
tax.classifyClassify a single tx_hash + chain as sale, swap, income, or transfer. Returns the cost-basis-relevant inputs and the disclaimer.
tax.bulkClassify an array of tx hashes (max 50) in a single call. Returns per-tx results plus a by-kind summary.
tax.today24-hour rollup of classified events by kind, with a taxable-signal subtotal. Free.

Backend endpoints

MethodPathPurpose
POST/v1/tax/eventSingle tx classification
POST/v1/tax/bulkBulk tx classification (max 50)
GET/v1/tax/today24h rollup
GET/v1/tax/healthService liveness

Classification model

Every classification is observational and derived from on-chain data alone:

KindSignal
saleSender sent assets out with no offsetting inflow (likely disposition).
swapSender both sent and received assets in the same tx (DEX-style).
incomeSender received assets with no offsetting outflow.
transferSame beneficial owner, no taxable inflow or outflow detected from this address.

A taxable_signal: true flag is set when the kind is one of sale, swap, or income. This is not a tax determination. It is a heuristic signal derived from the agent-supplied tx hash.

Run locally

bash
git clone https://github.com/srotzin/hive-mcp-tax-observer.gitcd hive-mcp-tax-observernpm installnpm start# server up on http://localhost:3000/mcpcurl http://localhost:3000/healthcurl http://localhost:3000/.well-known/mcp.json

Connect from an MCP client

Claude Desktop / Cursor / Manus — add to your mcp.json:

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

Quickstart

bash
# Classify a single Base transactioncurl -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
# Bulkcurl -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

What we do NOT do

  • We do not compute cost basis. We surface the inputs your basis tracker needs.
  • We do not file taxes, generate 1099s, or produce tax forms.
  • We do not make compliance determinations.
  • We do not provide tax advice. Consult a licensed tax professional.

Hive Civilization

Part of the Hive Civilization — sovereign DID, USDC settlement, agent-to-agent rails.

Categories: finance, tax, compliance, web3, agent-to-agent, observability.

License

MIT (c) Steve Rotzin / Hive Civilization

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Brand: #C08D23

来源：README.md，提交 8d49c61

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分