Lumoz MCP Server

A Model Context Protocol (MCP) server for interacting with the Lumoz blockchain, providing comprehensive blockchain information, token balances, and network statistics.

Features

• 🔍 Token Balances

  • Query native MOZ token balances
  • Check esMOZ (ERC20) token balances
  • Real-time balance updates
  • Direct links to block explorer for detailed information

• 📊 Verifier Information

  • Total staked licenses and esMOZ
  • Current APR and accumulated rewards
  • Top 10 nodes by esMOZ staking rewards
  • Top 10 nodes by license staking rewards
  • Detailed verifier statistics and rankings

• 📈 Chain Statistics

  • Total blocks, addresses, and transactions
  • Average block time
  • Contract statistics (total and verified)
  • Token information
  • 24-hour transaction metrics
  • Gas fee statistics and trends

• 🔌 Integration

  • Seamless MCP protocol support
  • Easy integration with AI tools
  • Simple API interface
  • Real-time data updates

Installation

Using npm

npm install lumoz-mcp

Using yarn

yarn add lumoz-mcp

Usage

As a CLI Tool

npx lumoz-mcp

As a Library

import { McpServer } from "lumoz-mcp";

// Create server instance
const server = new McpServer();

// Connect to transport
await server.connect(transport);

API Documentation

get_moz_balance

Get the native MOZ token balance for a given address.

Parameters

• address: Lumoz address (string)

Return Value

• MOZ token balance (18 decimal places)
• Direct link to block explorer for detailed information

Example

const balance = await server.get_moz_balance("0x123...");
console.log(`Balance: ${balance} MOZ`);

get_esmoz_balance

Get the esMOZ (ERC20) token balance for a given address.

Parameters

• address: Lumoz address (string)

Return Value

• esMOZ token balance (18 decimal places)
• Direct link to block explorer for detailed information

Example

const balance = await server.get_esmoz_balance("0x123...");
console.log(`esMOZ Balance: ${balance}`);

get_verifier_info

Get comprehensive information about Lumoz verifiers and staking statistics.

Return Value

• Staking Overview

  • Total staked licenses
  • Total staked esMOZ
  • Total accumulated rewards
  • Current APR

• Top Performers

  • Top 10 nodes by esMOZ staking rewards
    • Node name
    • Staked esMOZ amount
    • Staking reward rate
    • Node level
  • Top 10 nodes by license staking rewards
    • Node name
    • Staked licenses
    • Delegate reward rate
    • Node level

Example

const verifierInfo = await server.get_verifier_info();
console.log(verifierInfo);

get_chain_stats

Get detailed Lumoz chain statistics and metrics.

Return Value

• Network Statistics

  • Total blocks
  • Total addresses
  • Total transactions
  • Average block time (in seconds)

• Contract Information

  • Total contracts
  • Verified contracts
  • Total tokens

• 24-Hour Metrics

  • Transaction count
  • Average transaction fee (in MOZ)
  • Total gas fees (in MOZ)

Example

const chainStats = await server.get_chain_stats();
console.log(chainStats);

Configuration

Add the following configuration to your Claude Desktop configuration file:

{
    "mcpServers": {
        "lumoz-mcp": {
            "command": "npx",
            "args": ["lumoz-mcp"]
        }
    }
}

Development

Prerequisites

• Node.js
• TypeScript
• npm or yarn

Local Development

1. Clone the repository

git clone https://github.com/your-org/lumoz-mcp.git
cd lumoz-mcp

2. Install dependencies

npm install

3. Build the project

npm run build

4. Start development mode

npm run dev

Dependencies

• @modelcontextprotocol/sdk
• axios
• ethers
• viem
• zod

License

ISC