{"_id":"@bvcc/agent-mcp","_rev":"13-f742a2e030567d88093db1ffc08031cd","name":"@bvcc/agent-mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"@bvcc/agent-mcp","version":"0.1.0","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.0","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"23ac42a7757b6f8c0a9a4e39b4274d55682ed146","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.0.tgz","fileCount":19,"integrity":"sha512-9cKDBpTIUNvtJzslCsdgiqQwC913IaKeuvquPEmDR/0DBTE3+OzWduDb0gqdf9HWfWZ6mzSL4W46YkKJ7J3QpA==","signatures":[{"sig":"MEUCIQDRf09lLiqYs6+nuzYDAFJjLDmz8mugono0tdx2Ou7X4QIgFicCkmDyWE+olAeN97gjpwNlqe4PfiiMs7IveybX7Rc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2085476},"type":"module","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.0_1782207885652_0.6691455922534388","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bvcc/agent-mcp","version":"0.1.1","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.1","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"b3468e4088635e56b946eee95f9adaf94a9d3332","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.1.tgz","fileCount":19,"integrity":"sha512-+f0VVRG4ZOE25VEUOXAkPcH7W8UQ0qq4kNHzXqrwceoKgRN580KYSuhwCDlvkARO3+D0Ome+xlhq4kLp04XePw==","signatures":[{"sig":"MEUCIQC+7CNGJrYWtIbjPBmBSQdnwdNKrZRIoNz+l2fPlGUBKQIgU/RFr/wKgGa3HdbGQ7rILK4MqF7WaMXnKu6NP1RSXKM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2086406},"type":"module","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.1_1782208626096_0.4373331724768583","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bvcc/agent-mcp","version":"0.1.2","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.2","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"3964e6cf5f54dda31cb3cbd92b3c3f101eaa11a7","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.2.tgz","fileCount":19,"integrity":"sha512-vXHcayclVhmhiyWQm0tZRuHs1Xvx75y53yVi2ut50+CGGaOFyyppT/Suc0ED8a9S7b9DrkRuyIRk1AeVZSHVvw==","signatures":[{"sig":"MEYCIQCdgpUc6XNDIWX7/mY/vzfQyyEhh2vIGZjtYwvlAL+mtgIhAK4eTv5wIRYKblEuIqcvOHnXQzPV6iuXPCQHpJCZVT/S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2086893},"type":"module","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.2_1782238327542_0.3597158645193479","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@bvcc/agent-mcp","version":"0.1.3","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.3","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"a35ee978b210de7a9d76a48e7417258d916ef4be","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.3.tgz","fileCount":19,"integrity":"sha512-uUdJjP+6q+fr16oUwO7udcgyq6FzzFhUGiTxADsobLeiulGmtY9SG9O/OkTXXUpP2WDmpcJ+GpJOKD8d5dmbPA==","signatures":[{"sig":"MEYCIQDpbIG0ubQGEWdCmdgT4RVEZhwLbAtVOoAx2iXcO1976QIhANn5jVYfi0FMcAeVETSK65BC7LSxIUlnhSY2SsLVd4b0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2087163},"type":"module","mcpName":"io.github.blockventurechaincapital-crypto/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.3_1782645977356_0.053412067755389536","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@bvcc/agent-mcp","version":"0.1.4","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.4","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"635e27178927c527b5bf3db67943e2d4c5a78d30","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.4.tgz","fileCount":19,"integrity":"sha512-gBKMj8BtKpt+L8fgLnAWUrWedg/Jqq13W4gQQU8DIK74tnhvl/Gw2qlyYsUcm4F1yRFuwhkspDPMDeDpgEnjCg==","signatures":[{"sig":"MEQCICPSh+UR2O8hZ4SV37DDhyR87gW6KJ6UHMou9F4PuKWPAiA3RTlRouUIprOQMv1OTa0SuIoydXlWlGMN/vv0u6GJjw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2087222},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.4_1782646597195_0.961321576487925","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@bvcc/agent-mcp","version":"0.1.5","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.5","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"4b066247f2bdfa9bad2af36e96f95cdf40358ee9","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.5.tgz","fileCount":19,"integrity":"sha512-2D4Hw83ZKe4EttaWNZH22a+tog5LpsViEHuvGfDARAtvP/PhUVXe2bJbKc64qfT8fvcVWKeVPi+PnO7IFk4NZQ==","signatures":[{"sig":"MEQCIEOsDSLlSZ3R3m/KFHzVv3VJNFfELHNENCxD8AJYTB3iAiAI5XW+7L/SDlIGAuhnjxH02YgLUFl4n1cH9HZSDlO1lQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2092989},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.5_1782661489788_0.639043478277098","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@bvcc/agent-mcp","version":"0.1.6","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.1.6","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"1092882a10673f9e242959d4732db3c023ab8088","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.1.6.tgz","fileCount":19,"integrity":"sha512-pYpnRp9SFKL9+b1kLU4iod6udYUgaspJAvt3xMqqBQvAwBLGiDaGxOxw96v1wDXdfdpz7t1KdTgpcWMpX3CO4w==","signatures":[{"sig":"MEUCIANq5tmDFhDfvJ7HITaV35hkhpBeNrbbKSazQySgN6dEAiEA+Og1TiSxaFFzCxCo19Np4r/bpqU5OnWx5H2DXXjYwBQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2094596},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.1.6_1782762436938_0.8202861090303033","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@bvcc/agent-mcp","version":"0.2.0","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.2.0","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"1dc00c615fd7d9385ca73eb6bd5e3410f66327ff","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.2.0.tgz","fileCount":19,"integrity":"sha512-24Zw4kWjV+dBnqJEJ1SE5LzjMURyw3opXmuA0gGeK72MncSF6f2on0DbOrKZZ8qRJmsCzcN9OV9tPZbFUpDr4Q==","signatures":[{"sig":"MEYCIQDpI9oHweksZb5o6wPzG/zhwNxytd4spXAw4xOq9wp6NwIhAOrnZDBJwGC4WiuM9ah6E+c1vynGE5pO8n7GE/gaJREe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2258694},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.2.0_1785103093463_0.5166616740860097","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@bvcc/agent-mcp","version":"0.2.1","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.2.1","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"acbb20ba651ad87bf3a4f44d609e8aebd64b977f","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.2.1.tgz","fileCount":19,"integrity":"sha512-E7l2sSKdNkX7M1IpnqPb00DR0+ZuWaUZR4LVm/U69wmhRclqQUnAwtLt2CVRtsZlJBaEd7BYoD6ao0Ec9RJP9Q==","signatures":[{"sig":"MEQCICLwO7O78i9wJctt2Q0N9ZNnKeGuxkifn41jMXkPr+n8AiB4WYSLLAMhDSLkZaiv70IegPorwMxMIAdWZvb15WcpXg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2261032},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.2.1_1785233868636_0.4849182134395711","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@bvcc/agent-mcp","version":"0.2.2","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.2.2","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"1dfcacf22aebb1bdaa33d9f3d69a6c545ffb40da","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.2.2.tgz","fileCount":19,"integrity":"sha512-BZXUs12aHUPk78geRrNLoGYkfw3ad465XvKn57dCtGcwFaFrjWDX7txwXuKE4wk39aBZ1TcR95YSTER+a7KSyw==","signatures":[{"sig":"MEQCIEtJCWh/fKGYUO1yvA3Kkas2J02ib4R9/HjuWRlxETKEAiB4gktXfm7d0pfbfjLk37Atu+q71OhQtQKIVGl2tyHqlw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2262237},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.2.2_1785411406250_0.9685017917617398","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@bvcc/agent-mcp","version":"0.3.0","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.3.0","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"1682c14035b466ee1a95989b27d1834d36f09752","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.3.0.tgz","fileCount":19,"integrity":"sha512-ktw8G5/s7PAVYnz0CqzHeq/wp2ALbVrYZdJuVXPSWaIRUgNyunVCTeY6uSRmhCsYv8J5VirDezgHHS9tIFlPnA==","signatures":[{"sig":"MEUCIQCi40U1/h6PFdLIllDZA3SZCmAmNSKXWA5WAQ87i3baqwIgYl8NiBbAUBIIn1QbiqXM1+Bg/oNGSkXfymQRn/SowMk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIBdh6yXYm/x+MlCwx0c+iife/rdbsQN5lBTUmhTdsLrJAiEA5TVKzThkDO/Osc19p+plkYwbWpy8AJszd1hP2eevikg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2322777},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.3.0_1793742789173_0.5284365927849978","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@bvcc/agent-mcp","version":"0.3.1","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"license":"MIT","_id":"@bvcc/agent-mcp@0.3.1","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"homepage":"https://bvccwallet.blockventurechaincapital.com","bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"bin":{"bvcc-agent-mcp":"dist/server.js"},"dist":{"shasum":"888adf3c09368870a4e58b7c82a316eb801646a6","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.3.1.tgz","fileCount":19,"integrity":"sha512-Vz45WuH4kOlzzId6iWT0uSktg+M1z2knehLbbwndgz2HdiURbca6A+2OQpb5YrDTHI+8etEchB5bPTwiBLwxwg==","signatures":[{"sig":"MEYCIQC3Mv9dmodd6PfoXNBuf55Wh0Hn3x0OmYdU5OEDeZwZ+gIhAIhPikaP8eyxKChcEp6D2XAoy0QwjAnXWh1gaWVlUGIJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCUnmi5Cznfcrkb+jseCAFRm/1gZ+fljH2naSUTiLJXjwIhAJBDa/3Lq+qH4yvOy1L43e/ZF3bRz8/RKyn45NRLZb9n","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2327835},"type":"module","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"tmp":"tmp/agent-mcp_0.3.1_1793831903432_0.8697148019613505","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"_id":"@bvcc/agent-mcp@0.4.0","bin":{"bvcc-agent-mcp":"dist/server.js"},"bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"dist":{"shasum":"5bf4aaf72685b491c8b78e204671598d068a4b10","tarball":"https://registry.npmjs.org/@bvcc/agent-mcp/-/agent-mcp-0.4.0.tgz","fileCount":19,"integrity":"sha512-vl8RU34ffDI7X1rXtLY978jCSvd7nkaj+lcyMGMrRH9PvrNBRlodnEao6RXZal6d4CEA3O4cbpMuGQBM9EwW4w==","signatures":[{"sig":"MEUCIQCIyTCEyX8AyCn0/SdxuLJ3uc4Cp1v8fQAfKtl3FX620QIgGo0kRVpDDrK0zh9yonBNyxu9qakeoQWuAP6ajITJxOk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCF/TTcq1IcLonSiO3NvH6WeyOstnOeJV0aM8pq7U8EPgIgNrGlvxvGY5X4GAFVhG+llaTv3AVY6JXOplq7fe6dnUs="}],"unpackedSize":2347899},"name":"@bvcc/agent-mcp","type":"module","license":"MIT","mcpName":"com.blockventurechaincapital/bvcc-agent-wallet","scripts":{"dev":"tsx src/server.ts","test":"npm run build && node test/smoke.mjs","build":"tsup","start":"node dist/server.js","inspect":"npx @modelcontextprotocol/inspector tsx src/server.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm test"},"version":"0.4.0","_npmUser":{"name":"rami8612","email":"blockventurechaincapital@gmail.com"},"homepage":"https://bvccwallet.blockventurechaincapital.com","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"overrides":{"ws":"^8.21.0"},"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","directories":{},"maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.25.76","viem":"^2.21.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","typescript":"^5.4.0","@types/node":"^26.0.0","@bvcc/agent-sdk":"file:../bvcc-agent-sdk"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-mcp_0.4.0_1794172171474_0.3650922204435275"}}},"time":{"created":"2026-06-23T09:44:45.466Z","modified":"2026-11-08T21:09:31.782Z","0.1.0":"2026-06-23T09:44:45.828Z","0.1.1":"2026-06-23T09:57:06.256Z","0.1.2":"2026-06-23T18:12:07.775Z","0.1.3":"2026-06-28T11:26:17.524Z","0.1.4":"2026-06-28T11:36:37.378Z","0.1.5":"2026-06-28T15:44:49.991Z","0.1.6":"2026-06-29T19:47:17.087Z","0.2.0":"2026-07-26T21:58:13.628Z","0.2.1":"2026-07-28T10:17:48.832Z","0.2.2":"2026-07-30T11:36:46.430Z","0.3.0":"2026-11-03T21:53:09.300Z","0.3.1":"2026-11-04T22:38:23.559Z","0.4.0":"2026-11-08T21:09:31.609Z"},"bugs":{"url":"https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/issues"},"license":"MIT","homepage":"https://bvccwallet.blockventurechaincapital.com","keywords":["bvcc","mcp","model-context-protocol","ai-agent","smart-wallet","ethereum","viem"],"repository":{"url":"git+https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp.git","type":"git"},"description":"Model Context Protocol server exposing a BVCC Agent Wallet to AI runtimes (Claude Code, Cursor, Claude app). Tools are generated from the @bvcc/agent-sdk capability catalog.","maintainers":[{"name":"rami8612","email":"blockventurechaincapital@gmail.com"}],"readme":"<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/blockventurechaincapital-crypto/bvcc-agent-mcp/main/assets/bvcc_wallet.png\" alt=\"BVCC Wallet\" width=\"180\" />\n</p>\n\n<p align=\"center\">\n  <a href=\"https://glama.ai/mcp/servers/blockventurechaincapital-crypto/bvcc-agent-mcp\">\n    <img src=\"https://glama.ai/mcp/servers/blockventurechaincapital-crypto/bvcc-agent-mcp/badges/card.svg\" alt=\"bvcc-agent-mcp MCP server\" />\n  </a>\n</p>\n\n# @bvcc/agent-mcp\n\n**Model Context Protocol server for a BVCC Agent Wallet.** It lets MCP-speaking\nAI runtimes — Claude Code, Cursor, the Claude desktop app — operate a BVCC Agent\nWallet on-chain: check balances and limits, plan and simulate swaps, send tokens,\nswap on Uniswap v3/v4 (including to and from native ETH), **provide liquidity on\nUniswap v3/v4** (including native-ETH pools), and **lend, borrow and unwind\npositions on Aave v3** — including closing or deleveraging a position in safe\nsteps on its own. It also ships built-in **operating guides** (`listGuides` /\n`getGuide`, also exposed as prompts) so an agent can learn how to use each area on\ndemand.\n\nEvery tool is generated from the [`@bvcc/agent-sdk`](https://www.npmjs.com/package/@bvcc/agent-sdk) capability\ncatalog. There is no per-tool code here: add a capability to the SDK catalog and\nit appears here automatically.\n\n> **New here? Start with [QUICKSTART.md](https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/blob/main/QUICKSTART.md)** — the full end-to-end\n> setup (create wallet → authorize the agent on-chain → fund it with gas → configure\n> → verify). It covers the two steps people miss without which the agent does nothing.\n\n## Security\n\nThis server **adds no powers**. All limits — spend caps (native + per-token,\ndaily + total), allowed tokens, allowed protocols, recipient whitelist, and a\nglobal pause — are enforced **on-chain** by the Agent Wallet contract. The worst\nany tool can do is bounded by what you authorized for the agent in the BVCC\ndashboard.\n\n- The agent's **private key** is read from the environment, used locally to sign,\n  and **never transmitted**. BVCC does not receive, store, or custody it.\n- Tools are exposed **explicitly** via the SDK catalog — nothing is auto-discovered.\n- Set `BVCC_MCP_READONLY=true` to expose only read/simulate tools (no writes).\n\n## Tools\n\nGenerated from the catalog and tagged by class:\n\n**Core** (wallet, transfers, swaps):\n\n| Class | Tools |\n|-------|-------|\n| 🟢 read | `getAgentStatus`, `getCapabilities`, `getNativeBalance`, `getTokenBalances`, `getRemaining`, `needsApproval` |\n| 🟡 simulate | `buildSwapPlan`, `dryRunSendNative`, `dryRunSendToken`, `dryRunSwapV3`, `dryRunSwapV4`, `dryRunWrapNative`, `dryRunUnwrapNative` |\n| 🔴 write | `sendNative`, `sendToken`, `approve`, `swapV3`, `swapV4`, `swapToNative`, `swapFromNative`, `wrapNative`, `unwrapNative` |\n\n`wrapNative` / `unwrapNative` turn ETH into WETH and back, one to one. Moving between ETH\nand WETH is not a swap: `swapFromNative` with WETH as the output, or `swapToNative` with\nWETH as the input, does the same wrap or unwrap.\n\nA 0.15% BVCC agent fee is charged automatically on-chain on agent actions, separate\nfrom gas and from your spend budget.\n\n**Aave v3 lending** (`aave` module — Arbitrum, Ethereum, BNB, Base, Polygon):\n\n| Class | Tools |\n|-------|-------|\n| 🟢 read | `getAavePositions`, `getAaveMarket` |\n| 🟡 simulate | `dryRunAaveSupply`, `dryRunAaveBorrow`, `aavePlanClosePosition`, `aavePlanDeleverage`, `aavePlanCollateralSwap`, `aavePlanDebtSwap` |\n| 🔴 write | `aaveSupply`, `aaveWithdraw`, `aaveBorrow`, `aaveRepay`, `aaveRepayWithATokens`, `aaveSetCollateral`, `aaveSetEMode`, `aaveClosePosition`, `aaveDeleverage`, `aaveCollateralSwap`, `aaveDebtSwap` |\n\nDeposits and borrows are always **for the wallet itself** — no `to` or `onBehalfOf`\nparameter exists, because the wallet's on-chain call policies pin the beneficiary.\n\n⚠️ **The four `aave*` unwinding tools can send several transactions in one call.**\n`aaveClosePosition`, `aaveDeleverage`, `aaveCollateralSwap` and `aaveDebtSwap` run a\nchunked loop, re-deriving and re-simulating each step from live state. Call the\nmatching `aavePlan*` tool first to see what it intends to do. They stop rather than\nproceed if the health factor would fall below `hfFloor` (default 1.05), if a swap\nprices too far from the Aave oracle, if the loop stops making progress, or if the\nagent's budget would run out.\n\n**Uniswap liquidity** (`lp` module — open, collect, close positions on v3 & v4):\n\n| Class | Tools |\n|-------|-------|\n| 🟢 read | `getV3Position`, `getV4Position` |\n| 🟡 simulate | `dryRunAddLiquidityV3`, `dryRunRemoveLiquidityV3`, `dryRunAddLiquidityV4`, `dryRunRemoveLiquidityV4` |\n| 🔴 write | `addLiquidityV3`, `removeLiquidityV3`, `collectFeesV3`, `burnV3`, `addLiquidityV4`, `removeLiquidityV4`, `collectFeesV4`, `burnV4` |\n\nThe position NFT is minted **to the wallet** and every proceed returns to it —\npinned on-chain. `addLiquidityV3` sizes both sides to the pool's current price\n(full-range by default, or pass ticks). v4 covers **native-ETH pools**; its tools\nneed the v4 PositionManager's DEEP validator active on-chain for the agent, else\nthe action fails closed. Note there is no `increaseLiquidity` on v3 (not\nowner-gated on the NFPM — add by minting a fresh position).\n\n**Guides** (`meta` module — always exposed, help):\n\n| Class | Tools |\n|-------|-------|\n| 🟢 read | `listGuides`, `getGuide` |\n\n`listGuides` names the how-to guides; `getGuide({ area })` returns the playbook for\none area — the recommended workflow and the gotchas, naming the exact tools —\ncovering `getting-started`, `swaps`, `lending` and `liquidity`. They stay available\neven under a module filter, so an agent restricted to one feature can still learn\nhow to use it. The same guides are also exposed as **prompts** (`guide-<area>`) so a\nhuman can pull one as a slash-command.\n\nWrites carry the MCP `destructiveHint` annotation so clients can require\nconfirmation. See [GUIDE.md](https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/blob/main/GUIDE.md) for the recommended operating workflow.\n\n## Wallet V5\n\nThe server works with every wallet generation and detects which one it is talking to.\nOn a **V5** wallet a few things change, and the tools already apply them:\n\n- **Limits:** `0` allows nothing (before V5 it meant unlimited) and an empty recipient\n  list allows no recipient. Limits count the 0.15% agent fee too, so stay a little under\n  them; `getRemaining` shows the real headroom.\n- **Swaps** run through the Universal Router, between ERC-20 tokens. `swapV3` keeps\n  working: on V5 it is sent through the Universal Router for you.\n- **Permit2** allowances for swaps and v4 liquidity are granted by the wallet owner when\n  authorizing or renewing the agent, not by the agent.\n- **Native coin and Uniswap v3 liquidity** (wrap / unwrap, `swapToNative`,\n  `swapFromNative`, the v3 LP tools) work where their validators are active on that\n  network; `getCapabilities` says so. Elsewhere use WETH and v4 liquidity.\n- **Aave:** everything except `aaveRepayWithATokens`.\n- The owner can **pause** one agent, **block** a contract for every agent and **renew**\n  the expiry. `getAgentStatus` and `getCapabilities` report all of it.\n\nAnything V5 does not allow comes back as a failed result with a plain explanation,\nbefore any gas is spent.\n\n## Good to know\n\n- **Retry or not.** Every failed result carries `retryable`. When it is `false` the same\n  call will fail again (a budget is used up, a permission is missing, the balance is\n  short): change the input or ask the owner instead of repeating it.\n- **Liquidity ranges as prices.** The LP tools take `priceLower` / `priceUpper` instead\n  of raw ticks. A range that does not contain the current price needs a confirmation:\n  the first call stops and asks, and `allowOutOfRange: true` opens it.\n- **Gas margin.** Transactions are sent with 20% more gas than the estimate; unused gas\n  is not paid.\n- **Source tag.** Each transaction ends with 8 bytes naming the tool that built it (the\n  BVCC MCP) and its version, so BVCC can tell which releases are in use and tie failures\n  to a version. It carries nothing about you, your wallet or your agent, and the wallet\n  ignores it.\n\n## Configuration\n\n**Recommended:** keep the values — above all `AGENT_PRIVATE_KEY` — in a dedicated\nenv file and point the server at it with `BVCC_ENV_FILE`, instead of inlining the\nkey in your MCP host's config (which gets shared, synced and screenshotted).\n`chmod 600` that file and keep it outside any cloud-synced folder. You *can* still\ninline the variables in the host's `env` block if you prefer; host env wins over\nthe file. See [`.env.example`](https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/blob/main/.env.example).\n\nExample `agent.env` (path passed via `BVCC_ENV_FILE`):\n\n```bash\nAGENT_PRIVATE_KEY=0xYOUR_AGENT_KEY\nWALLET_ADDRESS=0xYOUR_WALLET\nCHAIN_ID=42161\n```\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `AGENT_PRIVATE_KEY` | yes | Agent EOA private key (`0x` + 64 hex). Used locally only. |\n| `WALLET_ADDRESS` | yes | The BVCC Agent Wallet this agent operates. |\n| `CHAIN_ID` | yes | **Default** chain: `42161` Arbitrum One · `56` BNB · `1` Ethereum · `8453` Base · `137` Polygon · `421614` Arbitrum Sepolia. |\n| `RPC_URL` | no | Custom RPC for the default chain (otherwise a public default). |\n| `RPC_URL_<chainId>` | no | Per-chain RPC override, e.g. `RPC_URL_56`. |\n| `BVCC_ENV_FILE` | no | Path to a dedicated env file to load (keeps the key out of the host config). Host env wins over it. |\n| `BVCC_MCP_READONLY` | no | `true` exposes only read/simulate tools. |\n| `BVCC_MCP_MODULES` | no | Comma-separated feature groups to expose: `core`, `aave`, `lp`. Unset = all. |\n| `BVCC_NO_UPDATE_CHECK` | no | `1` turns off the new-version check (see [Upgrading](#upgrading)). |\n\n**Narrowing what the agent can reach.** `BVCC_MCP_READONLY` and `BVCC_MCP_MODULES`\nare independent and combine. If an agent will never touch lending, leaving those\ntools out is one less thing it can get wrong:\n\n```bash\nBVCC_MCP_MODULES=core              # wallet + swaps    (22 + 2 guides = 24)\nBVCC_MCP_MODULES=aave              # Aave lending      (19 + 2 = 21)\nBVCC_MCP_MODULES=lp                # Uniswap liquidity (14 + 2 = 16)\nBVCC_MCP_MODULES=core,aave,lp      # everything (= unset)  (55 + 2 = 57)\nBVCC_MCP_MODULES=core\nBVCC_MCP_READONLY=true             # read-only wallet  (13 + 2 = 15)\n```\n\nThe two guide tools (`listGuides`, `getGuide`, module `meta`) are always exposed on\ntop of these — that is the `+ 2` — so an agent restricted to one feature can still\nread how to use it.\n\nAn unrecognised module name is ignored, so a typo yields a *smaller* surface, never\na larger one. Neither switch is the security boundary — the contract is — but a\nsmaller surface is fewer ways for a confused agent to act.\n\n**Multi-network:** one server operates the agent on any supported chain. Every\ntool takes an optional `network` (chain id or name: `ethereum`, `bsc`, `arbitrum`,\n`base`, `polygon`, `arbitrum-sepolia`), defaulting to `CHAIN_ID` — so you can say \"swap on\nbsc\" without restarting. The wallet address is the same on every chain (CREATE2);\nthe agent must be authorized on each chain you use.\n\n## Install & build\n\n```bash\nnpm install\nnpm run build\nnpm test          # builds + stdio smoke test (no chain calls)\n```\n\n## Connect to a client\n\n### Claude Code\n\n```bash\nclaude mcp add bvcc-agent-wallet \\\n  --env BVCC_ENV_FILE=/secure/agent.env \\\n  -- npx -y @bvcc/agent-mcp@latest\n```\n\n### Cursor / Claude app (`mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"bvcc-agent-wallet\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bvcc/agent-mcp@latest\"],\n      \"env\": { \"BVCC_ENV_FILE\": \"/secure/agent.env\" }\n    }\n  }\n}\n```\n\nThe key lives in `agent.env`, not in the config above. If you'd rather inline it,\nreplace the `env` block with `AGENT_PRIVATE_KEY` / `WALLET_ADDRESS` / `CHAIN_ID`\ndirectly (less safe — the key sits in the host config). `@latest` keeps you on the\nnewest release; to stay on one version instead, see [Upgrading](#upgrading).\n\n## Upgrading\n\nThe SDK is bundled into this package, so **updating the MCP is all you need** to get\nnew capabilities (Aave lending shipped this way in 0.2.0) — you never install or update\n`@bvcc/agent-sdk` separately.\n\n1. **Use `@latest`** (recommended), as in the examples above. `npx` caches, so a\n   plain `@bvcc/agent-mcp` with no tag can keep running an old build; `@latest` checks\n   for a newer one each time the client starts the server.\n   To stay on one version instead, pin it and bump the number yourself when you upgrade:\n   ```json\n   \"args\": [\"-y\", \"@bvcc/agent-mcp@0.3.1\"]\n   ```\n   Global installs: `npm i -g @bvcc/agent-mcp@latest`.\n2. **Restart your MCP client.** New tools from the catalog appear automatically;\n   nothing else in the config changes. The startup banner prints the running\n   version (`[bvcc-agent-mcp vX.Y.Z]`).\n3. ⚠️ **Authorize any new protocol on-chain.** A release that adds a new protocol\n   (e.g. Aave) exposes its tools immediately, but the agent must have that\n   protocol's contract in its `allowedProtocols` — otherwise the action reverts\n   with `ProtocolNotAllowed`. Authorize it from the dashboard, same as a router.\n\n**Knowing when there is a new version.** When the server starts, it asks the public npm\nregistry which version of `@bvcc/agent-mcp` is the latest. This runs in the background\nand gives up after 2 seconds, so startup never waits on it or fails because of it. If a\nnewer version is out, the log prints `[bvcc-agent-mcp] update available 0.3.1 → 0.3.2 …`\nand `getAgentStatus` returns `updateAvailable: { current, latest, command, changelogUrl }`,\nwhich the agent passes on to you once. The request carries nothing about you, your wallet\nor your agent, though npm does see your IP address, the same as with any `npm install`.\nTo turn it off, set `BVCC_NO_UPDATE_CHECK=1`.\n\nSee [CHANGELOG.md](https://github.com/blockventurechaincapital-crypto/bvcc-agent-mcp/blob/main/CHANGELOG.md) for what each version changes. Versioning follows\nSemVer: patch = fix, minor = new compatible feature, and `0.x` means the API may\nstill change.\n\n## How it works\n\n```\n@bvcc/agent-sdk  ──catalog──►  @bvcc/agent-mcp  ──MCP──►  Claude Code / Cursor / Claude\n   (on-chain limits live in the Agent Wallet contract, not here)\n```\n\nThe server loads the catalog, registers one MCP tool per capability (Zod schema →\ntool input schema, `kind` → tool annotations), and routes each call to the SDK,\nwhich signs with the agent key and submits `executeAsAgent`.\n\n## License\n\nMIT © BlockVenture Chain Capital (BVCC)\n","readmeFilename":"README.md"}