Skip to main content
Glama

ulu-voi-mcp

Voi ecosystem MCP server. Returns meaning, not raw chain data.

Architecture

UluCoreMCP      → chain primitives (blocks, accounts, transactions)
UluVoiMCP       → Voi ecosystem meaning (protocols, identity, naming)
UluWalletMCP    → signing
UluBroadcastMCP → broadcasting

Core returns facts. Voi returns meaning.

Related MCP server: ENS MCP Server

Tools

Tool

Description

get_protocols

List all known Voi protocols, optionally filtered by type

get_protocol

Get detailed info about a specific protocol

get_protocol_contracts

List all contracts and assets for a protocol

get_protocol_summary

Human-readable protocol summary

identify_application

Identify what a Voi application ID is

identify_asset

Identify what a Voi asset ID is

search_assets

Search known assets by symbol, category, protocol, or verified status

get_contract_role

Get the role and purpose of a contract

resolve_name

Resolve an enVoi name from static registry

reverse_resolve_address

Reverse-resolve an address to known names

search_names

Search the name registry by pattern (with result limit)

Data Model

Curated registry files in data/:

  • protocols.json — protocol definitions (HumbleSwap, Nomadex, enVoi, Aramid, etc.)

  • applications.json — application ID → protocol, role, type mapping

  • assets.json — asset ID → name, symbol, category, protocol mapping

  • names.json — static well-known enVoi names

All registries are static JSON loaded at startup. For live data, use UluCoreMCP.

Setup

npm install

Usage

node index.js

Client Configuration

{
  "mcpServers": {
    "ulu-voi-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/ulu-voi-mcp/index.js"]
    }
  }
}

Protocols Covered

  • HumbleSwap — DEX (AMM pools)

  • Nomadex — DEX

  • SnowballSwap — DEX aggregator

  • enVoi — naming service

  • Nautilus — NFT marketplace

  • HighForge — NFT minting

  • DorkFi — lending protocol (deposits, borrowing, liquidations, WAD stablecoin)

  • Aramid Bridge — cross-chain bridge

  • NFT Navigator (Mimir) — indexer (ARC-200 tokens, ARC-72 NFTs, marketplace, DEX pools)

  • Kibisis — browser wallet

  • Voi Network — L1 blockchain

Naming Resolution

Static registry approach. The names.json file contains well-known enVoi names. For live resolution (on-chain lookups), use UluCoreMCP's envoi_resolve_address, envoi_resolve_name, and envoi_search tools.

Limitations

  • Registries are static and curated — not all applications or assets are covered

  • Name resolution is from a static registry, not live on-chain lookups

  • No write operations — this is a read-only meaning layer

  • Pool list may become stale as new pools are created

  • Community tokens marked unverified may change status

Available Tools

11 tools
get_contract_roleA

Get the role and purpose of a specific contract on Voi (e.g. liquidity-pool, bridge, registry)

Inputs: appId (required).

get_protocolA

Get detailed information about a specific Voi ecosystem protocol by ID

Inputs: protocolId (required).

get_protocol_contractsA

List all known application contracts for a Voi protocol

Inputs: protocolId (required).

get_protocolsB

List all known Voi ecosystem protocols with type and description

Inputs: type.

get_protocol_summaryA

Get a human-readable summary of a Voi protocol including its purpose, contracts, and assets

Inputs: protocolId (required).

identify_applicationA

Identify a Voi application by ID — returns protocol, role, type, and description if known

Inputs: appId (required).

identify_assetA

Identify a Voi asset by ID — returns name, symbol, type, protocol, and category if known

Inputs: assetId (required).

resolve_nameA

Resolve an enVoi name (e.g. 'shelly.voi') to its address and metadata from the static registry. For live resolution, use UluCoreMCP's envoi tools.

Inputs: name (required).

reverse_resolve_addressA

Look up well-known enVoi names associated with a Voi address from the static registry. For live resolution, use UluCoreMCP's envoi tools.

Inputs: address (required).

search_assetsB

Search known Voi assets by symbol, category, or protocol

Inputs: symbol, category, protocol, verified.

search_namesA

Search the static enVoi name registry by pattern. For live search, use UluCoreMCP's envoi tools.

Inputs: pattern (required), limit.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools target distinct resources (protocols, apps, assets, names) with different query strategies. Minor overlap exists between get_protocol and get_protocol_summary, and between get_protocol_contracts and get_contract_role, but descriptions clarify their different intents.

    Naming Consistency4/5

    Tool names follow a consistent verb_noun pattern (get_protocols, identify_asset, search_assets, resolve_name). Slight inconsistency in that several verbs are used (get, identify, search, resolve, reverse_resolve) but within each verb group the pattern is uniform.

    Tool Count5/5

    11 tools is well-scoped for a read-only ecosystem registry. Each tool serves a distinct query need without redundancy or bloat.

    Completeness4/5

    The tool set covers the core read operations for protocols, contracts, applications, assets, and enVoi names. Minor gaps exist such as no direct 'get all assets' or 'get contract details by ID' beyond role lookup, but the domain is well served overall.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides a semantic layer for the Voi ecosystem, translating raw blockchain data into human-readable information about protocols, applications, and assets. It enables users to identify contract roles, resolve enVoi names, and explore curated registry data for ecosystem services like HumbleSwap and Nautilus.
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with the Ethereum Name Service via natural language, supporting lookups, availability checks, pricing, subnames, and onchain records.
      15
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Cross-chain decentralized Web3 identity protocol. Canonical naming resolvable across all EVM networks via Chainlink CCIP and EIP-3668.
      -