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: UluAlgorandMCP

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

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

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

  • Aramid Bridge — cross-chain bridge

  • 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

10 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_namesA

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

Inputs: pattern (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: get_contract_role focuses on contract roles, get_protocol and get_protocol_summary provide different levels of protocol detail, get_protocol_contracts lists contracts, get_protocols lists protocols, identify_application and identify_asset handle different resource types, and the name tools (resolve_name, reverse_resolve_address, search_names) are clearly scoped to static registry operations. An agent can easily distinguish between them based on their specific targets.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case, using verbs like 'get', 'identify', 'resolve', 'reverse_resolve', and 'search' paired with specific nouns (e.g., contract_role, protocol, protocols, application, asset, name, address). This predictability makes it easy for an agent to understand the action and target from the name alone.

    Tool Count5/5

    With 10 tools, the count is well-scoped for the domain of Voi ecosystem information and static name registry operations. Each tool serves a unique function, covering protocol discovery, contract details, asset/application identification, and name resolution without redundancy, making the set efficient and focused.

    Completeness4/5

    The tool set provides comprehensive coverage for querying Voi protocols, contracts, assets, applications, and static name registry data, with clear CRUD-like operations (e.g., get, list, identify, resolve). A minor gap exists as the server defers live name resolution to another MCP server (UluCoreMCP), but this is explicitly noted and does not hinder core functionality, allowing agents to work around it.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      BotIndex MCP Server gives AI agents searchable access to verified on-chain and off-chain protocol metadata so they can discover, validate, and act on blockchain ecosystem data with less hallucination risk.
      38
      83 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Algorand ecosystem knowledge layer as an MCP server, enabling identification of applications and assets, protocol discovery, name resolution, and protocol summaries without on-chain queries.
      10
      MIT