Skip to main content
Glama
Vitruveo Chain Tools MCP

Vitruveo Chain Tools MCP

by UNI-ASYNC

Vitruveo Chain Tools MCP

Read-only Vitruveo mainnet tools, chain ID 1490. Release candidate 0.2.0-rc.1. One existing viem-based core serves standard stdio and authenticated Streamable HTTP. No wallet, signing, broadcasts or contract writes. Not an independent security audit.

Install locally

Node.js 22+. Extract the reviewed source archive to a stable folder. Windows: npm.cmd ci --ignore-scripts, npm.cmd test. macOS/Linux: npm ci --ignore-scripts, npm test. Configure your client to run node /absolute/path/src/stdio.js. It launches the server; no separate HTTP process is required. Standard output is reserved for MCP messages.

The 16 tools cover network status, balances, blocks/receipts, history pages, view calls, event decoding, bounded scans, ERC-20/ERC-721 probes, ABI/proxy observations, logs, block-author observations, supply arithmetic and historical-data point probes.

Default RPC: https://rpc.vitruveo.ai; explorer: https://explorer.vitruveo.ai. The live release smoke checked only network status and explorer availability. All 16 tools were invoked through stdio and authenticated local HTTP against fixtures. Automated tests use local mock providers. GUI clients and hosted ChatGPT connections have not been tested; the compatibility table distinguishes preparation from verification.

Historical calls or minted/outstanding shares are not paid sales. Missing original records and provider retention limits must remain explicit. Never present capped scans as complete. URI/ABI/explorer data is untrusted, and metadata URLs are never fetched.

Optional HTTP: see installation documentation. Loopback requires a private token; remote binding additionally requires HTTPS/OAuth/JWKS configuration. This package does not provide hosting, accounts or an authorization server. Nothing was deployed.

MIT source license; installed dependency declarations and advisory results accompany the candidate. Source archives exclude dependencies and private investigation material. Independent community utility; no claim of Vitruveo Foundation endorsement.

Available Tools

16 tools
address_history_pageaddress history pageB
Read-only

Read one Blockscout page with exact pagination cursor (transactions, logs, transfers, token holdings, internal transactions).

Inputs: address (required), kind, filters, pageCursor.

address_overviewaddress overviewC
Read-only

Native VTRU balance, contract status, explorer metadata including NFTs and proxy info.

Inputs: address (required).

block_detailsblock detailsC
Read-only

Read a block by number or latest.

Inputs: number.

chain_statuschain statusA
Read-only

Verify chain ID, RPC health, and current block.

Inputs: no named parameters.

contract_inspectcontract inspectC
Read-only

Observe bytecode, EIP-1967 proxy slots and explorer ABI metadata.

Inputs: address (required), blockNumber.

contract_logscontract logsC
Read-only

Read at most 2000 blocks and 500 log records; explicit completeness.

Inputs: address (required), toBlock (required), fromBlock (required), topic, +1 more.

decode_event_logsdecode event logsB
Read-only

Decode raw event log entries with a supplied Solidity event signature.

Inputs: logs (required), eventSignature (required).

historical_availabilityhistorical availabilityC
Read-only

Point probes of historical block and state; never proof of complete archive coverage.

Inputs: address, blockNumber.

native_balancenative balanceC
Read-only

Native VTRU balance at a pinned block.

Inputs: address (required), blockNumber.

nft_infonft infoB
Read-only

Read ERC-721 ownership and URI without fetching external metadata.

Inputs: address (required), tokenId (required), blockNumber.

read_contractread contractB
Read-only

Call any ABI-described view or pure method on an arbitrary contract, including proxies. No wallet signing.

Inputs: abi (required), address (required), functionName (required), args, +1 more.

reconcile_supplyreconcile supplyC
Read-only

Read caller-selected cap/outstanding/reserved getters at one block; never a paid-sales total.

Inputs: address (required), capFunction (required), reservedFunction (required), outstandingFunction (required), +1 more.

scan_address_transactionsscan address transactionsC
Read-only

Paginate public address incoming/outgoing transactions, group decoded methods, optionally sum uint quantity for one method, and flag incomplete runs. NOT proof of sales.

Inputs: address (required), filter, maxPages, maxRecords, +2 more.

token_infotoken infoC
Read-only

Read ERC-20 interface information and optional holder balance.

Inputs: address (required), holder, blockNumber.

transaction_detailstransaction detailsB
Read-only

Read transaction, receipt and Blockscout decoding by transaction hash.

Inputs: hash (required).

validator_observationsvalidator observationsC
Read-only

Sample block author fields; not proof of validator membership.

Inputs: sampleBlocks.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 16 tools

    Disambiguation3/5

    Several tools overlap: address_overview and native_balance both return native balance, address_history_page and scan_address_transactions both traverse address transactions, and contract_logs/decode_event_logs/historical_availability all touch logs or historical state. Descriptions add caveats and pinned-block distinctions, but an agent must read carefully to choose correctly.

    Naming Consistency3/5

    All names use snake_case, which is consistent, but the convention is split between noun phrases (chain_status, block_details, token_info) and verb phrases (read_contract, decode_event_logs, scan_address_transactions). The mixed style remains readable but is not a single predictable pattern.

    Tool Count4/5

    16 tools is slightly above the typical 3-15 range but reasonable for a read-only chain inspection and analysis surface. Each tool maps to a specific query type, though a few overlaps suggest some could be consolidated.

    Completeness4/5

    The surface covers core read-only chain workflows: status, blocks, transactions, addresses, contracts, logs, tokens, NFTs, validators, supply reconciliation, and historical probes. Minor gaps remain around gas estimation, broad event/topic filtering, and richer token/NFT enumeration, but no major dead ends for the stated purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-only access to the live NOVAI blockchain (an AI-native L1) over public JSON-RPC. Query blocks, transactions, AI entities, on-chain signals, oracle anchors, and memory objects. No keys, no write paths.
      12
      50 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides read-only, real-time access to TON blockchain data including wallet balances, token holdings, transactions, prices, NFTs, DNS resolution, and address validation, without requiring private keys.
      8
      46 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables clients to search, read, and verify sealed forecasts and public-record cards, inspect resolution calendars, engine strands, sensor alerts, and wire headlines, and check whether stories are independent events or echoes. All access is read-only and requires no key, account, or dependencies.
      5 npm
      1
      Apache 2.0