DigiMonk73/BTCTX-MCP

Started the BitcoinTX MCP server (btctx-mcp, installed from mcp_server/ via pip into a venv) over stdio, completed the MCP initialize handshake, and called tools/list, which returned 11 tools: get_ledger_guide, get_portfolio, list_transactions, get_btc_price, review_ledger, preview_transactions, add_transactions, update_transaction, delete_transaction, recalculate_ledger, backup_ledger.

cd <host-path> && git log --oneline -1 2>/dev/null; ls -la; cat README.md 2>/dev/null | head -300
ls -la <host-path> 2>/dev/null; echo "CDP_URL=$CDP_URL"; which node npm uv pip3 python3; python3 --version
cd <host-path> && sed -n 1,200p mcp_server/README.md; echo ----; ls mcp_server; cat backend/requirements.txt | head -5; grep -n "kind\|mcp" <host-path> | head -80
cd <host-path> && (python3 -m venv <host-path> 2>&1 || (sudo apt-get update -qq && sudo apt-get install -y -qq python3-venv >/dev/null 2>&1 && python3 -m venv <host-path>)) && <host-path> install -q ./mcp_server 2>&1 | tail -20; echo "rc=$?"; ls <host-path> | grep -i btctx
sudo apt-get install -y -qq python3.12-venv 2>&1 | tail -3; rm -rf <host-path> && python3 -m venv <host-path> && cd <host-path> && <host-path> install -q ./mcp_server 2>&1 | tail -20; echo "pip rc=${PIPESTATUS[0]}"; ls -la <host-path> | grep -i btctx
cd /tmp && { printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}' '{"jsonrpc":"2.0","method":"notifications/initialized"}' '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'; sleep 3; } | timeout 20 <host-path> 2>/tmp/btctx-stderr.txt | python3 -c 'import sys,json
for l in sys.stdin:
  m=json.loads(l)
  if m.get("id")==2: print([t["name"] for t in m["result"]["tools"]])
  elif m.get("id")==1: print("init ok:", m["result"]["serverInfo"])'; echo "stderr:"; head -5 /tmp/btctx-stderr.txt
cd <host-path> && ls -la .coldpass 2>/dev/null; mkdir -p .coldpass && cat > .coldpass/probe.json <<'EOF'
{"kind":"mcp","argv":["<host-path>"}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","operation":"Started the BitcoinTX MCP server (btctx-mcp, installed from mcp_server/ via pip into a venv) over stdio, completed the MCP initialize handshake, and called tools/list, which returned 11 tools: get_ledger_guide, get_portfolio, list_transactions, get_btc_price, review_ledger, preview_transactions, add_transactions, update_transaction, delete_transaction, recalculate_ledger, backup_ledger.","operation_scope":"MCP server start and tools/list only. Tools that read or write the ledger need a running BitcoinTX instance (BTCTX_URL) and an AI key (BTCTX_AI_KEY); neither was started or created, so no ledger calls were exercised. Unit tests and lint were not run, per the task.","steps":["Read README.md and mcp_server/README.md","python3 -m venv <host-path> (failed: ensurepip missing)","sudo apt-get install -y python3.12-venv","python3 -m venv <host-path> install -q ./mcp_server","Stdio MCP handshake: initialize, notifications/initialized, tools/list against <host-path>"],"deviations":["Plain python3 -m venv failed on the guest (ensurepip not available); installed python3.12-venv via apt and recreated the venv. The README's pip install line assumes an environment where this is not needed.","The README's `uvx btctx-mcp==X.Y.Z` path was not used; installed from the pinned checkout with pip, per the mcp_server/README.md 'pip install ./mcp_server' option."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
<env-var>=<host-path> python3 -I <host-path> --validate; echo rc=$?