English Français العربية

Hive Tax Observer

Registre officiel Finance et paiements

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hive-tax-observer 'https://hive-mcp-tax-observer.onrender.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hive-tax-observer": {
            "type": "http",
            "url": "https://hive-mcp-tax-observer.onrender.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Hive Tax Observer
  2. What this is
  3. Tools
  4. Backend endpoints
  5. Classification model
  6. Run locally
  7. Connect from an MCP client
  8. Quickstart
  9. What we do NOT do
  10. Hive Civilization
  11. License
  12. Hive Civilization Directory

Hive Tax Observer

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

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

Connect from an MCP client

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"]
    }
  }
}

Quickstart

# 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

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

Questions fréquentes

Qu'est-ce que Hive Tax Observer ?

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

Comment installer Hive Tax Observer ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http hive-tax-observer 'https://hive-mcp-tax-observer.onrender.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Hive Tax Observer ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Hive Tax Observer est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Hive Tax Observer ?

Il est publié par srotzin. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.