Hive Tax Observer

io.github.srotzinPublished by GitHub account srotzinv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Read-only MCP server that classifies settled crypto transactions on Base, Ethereum and Solana as sale, swap, income or transfer and returns cost-basis inputs.

What you can do
  • Classify a single transaction by hash and chain into sale, swap, income or transfer, returning holder, asset, amount, counterparty and timestamp.
  • Classify up to 50 transaction hashes in one bulk call with a per-kind summary.
  • Get a 24-hour rollup of classified events by kind with a taxable-signal subtotal.
  • Check service health and supported chains.
When to use it
Useful when an assistant needs to sort on-chain crypto transactions into rough event kinds and gather the raw inputs a separate cost-basis tracker or tax professional would need. It is observational only, so it suits bookkeeping prep and monitoring rather than compliance decisions.
Requirements
A remote Streamable-HTTP endpoint at the provider's hosted URL (POST /mcp); no authentication, environment variables or headers are declared. Local runs need Node.js and npm. It reads Base, Ethereum and Solana mainnet through public RPC.
Before you install
Results are heuristic signals from on-chain data, not tax advice, cost-basis calculations, filings or compliance determinations; the README repeatedly says to consult a licensed tax professional. Transaction hashes and chain names are sent to the provider's backend service. No credentials are requested, but the hosted endpoint is third-party infrastructure.

Installation

In SourceWeft

  1. Open Hive Tax Observer in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-tax-observer/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit 8d49c61

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts