Read-only tax event observation for agent-to-agent transaction streams
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-srotzin-hive-mcp-tax-observer": {
"command": "<see-readme>",
"args": []
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Read-only tax event observation for agent-to-agent transaction streams
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Click any tool to inspect its schema.
This server is missing a description.If you've used it, help the community.
Add informationBe the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in finance
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
A Model Context Protocol (MCP) server that provides AI assistants with direct access to the Spreedly payments API. Enables LLMs to manage gateways, process transactions, tokenize payment methods, and more, through structured, validated tool calls.
MCP server for InsightSentry financial data API - market data, options, screeners, and more
AI agents get on-chain identity, credentials, reputation, escrow, and persistent memory on XRPL.
MCP Security Weekly
Get CVE alerts and security updates for io.github.srotzin/hive-mcp-tax-observer and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
POST /mcpGET /.well-known/mcp.jsonGET /health (200, brand_color, disclaimer, enabled, supported_chains)https://hivemorph.onrender.com — /v1/tax/*#C08D23 (Pantone 1245 C)| Tool | Description |
|---|---|
tax.classify | Classify a single tx_hash + chain as sale, swap, income, or transfer. Returns the cost-basis-relevant inputs and the disclaimer. |
tax.bulk | Classify an array of tx hashes (max 50) in a single call. Returns per-tx results plus a by-kind summary. |
tax.today | 24-hour rollup of classified events by kind, with a taxable-signal subtotal. Free. |
| Method | Path | Purpose |
|---|---|---|
POST | /v1/tax/event | Single tx classification |
POST | /v1/tax/bulk | Bulk tx classification (max 50) |
GET | /v1/tax/today | 24h rollup |
GET | /v1/tax/health | Service liveness |
Every classification is observational and derived from on-chain data alone:
| Kind | Signal |
|---|---|
sale | Sender sent assets out with no offsetting inflow (likely disposition). |
swap | Sender both sent and received assets in the same tx (DEX-style). |
income | Sender received assets with no offsetting outflow. |
transfer | Same 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.
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
Claude Desktop / Cursor / Manus — add to your 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