ValiScore MCP Server

The ValiScore MCP Server provides AI assistants with direct access to Bittensor validator analysis and scoring capabilities. It implements the Model Context Protocol (MCP) standard, enabling seamless integration with any MCP-compatible client.

Key Features

• Real-time Analysis: Live Bittensor subnet analysis with blockchain data
• Scoring Tools: BLEU, ROUGE, and Shapley value calculations
• Multi-network Support: Connect to finney, test, or local networks
• Resource Discovery: Queryable subnet and validator information
• Standardized Interface: MCP v1.0 compliant server

MCP resources provide queryable access to Bittensor data and analysis results.

Example

# List available resources
resources = await session.list_resources()
print(f"Available resources: {[r.uri for r in resources.resources]}")

# Read a specific resource
content = await session.read_resource("subnet://finney/1")
print(content.text)

Environment Variables

Configuration File

# config.yaml
mcp_server:
  host: localhost
  port: 8000
  network: finney
  timeout: 30
  max_concurrent: 10
  log_level: INFO

bittensor:
  default_network: finney
  connection_timeout: 30
  retry_attempts: 3

scoring:
  default_weights:
    bleu: 0.4
    rouge1: 0.3
    rouge2: 0.2
    rougeL: 0.1

JavaScript/TypeScript Client

import { ClientSession, StdioServerParameters } from '@modelcontextprotocol/sdk/client/index.js';

async function main() {
    const session = new ClientSession(
        new StdioServerParameters({
            command: 'valiscore-cli',
            args: ['mcp-server']
        })
    );
    
    await session.initialize();
    
    try {
        // Analyze a subnet
        const result = await session.callTool('analyze_subnet', {
            subnet_id: 1,
            network: 'finney'
        });
        console.log('Analysis result:', result.content[0].text);
        
    } finally {
        await session.close();
    }
}

main().catch(console.error);

Rust Client

use mcp::client::{ClientSession, StdioServerParameters};

#[tokio::main]
async fn main() -> Result<(), Box> {
    let session = ClientSession::new(
        StdioServerParameters::new("valiscore-cli", vec!["mcp-server"])
    ).await?;
    
    // Analyze a subnet
    let result = session.call_tool("analyze_subnet", serde_json::json!({
        "subnet_id": 1,
        "network": "finney"
    })).await?;
    
    println!("Analysis result: {}", result.content[0].text);
    
    Ok(())
}

Complete Analysis Workflow

import asyncio
from mcp import ClientSession, StdioServerParameters

async def complete_workflow():
    async with ClientSession(
        StdioServerParameters(
            command="valiscore-cli",
            args=["mcp-server", "--network", "finney"]
        )
    ) as session:
        
        # 1. Analyze subnet
        analysis = await session.call_tool("analyze_subnet", {
            "subnet_id": 1
        })
        print("Subnet Analysis:", analysis.content[0].text)
        
        # 2. Compare multiple subnets
        comparison = await session.call_tool("compare_subnets", {
            "subnet_ids": [1, 2, 3]
        })
        print("Subnet Comparison:", comparison.content[0].text)
        
        # 3. Score some responses
        scores = await session.call_tool("score_responses", {
            "reference": "The answer is 42",
            "responses": ["The answer is 42", "It's 42", "42 is the answer"]
        })
        print("Response Scores:", scores.content[0].text)
        
        # 4. Calculate Shapley values
        shapley = await session.call_tool("calculate_shapley", {
            "contributions": [0.8, 0.6, 0.9]
        })
        print("Shapley Values:", shapley.content[0].text)
        
        # 5. Export results
        export = await session.call_tool("export_analysis", {
            "subnet_id": 1,
            "format": "json"
        })
        print("Export Result:", export.content[0].text)

asyncio.run(complete_workflow())

Common Issues

Debug Mode

# Start server in debug mode
valiscore-cli mcp-server --verbose --log-level DEBUG

# Check server logs
tail -f valiscore_mcp.log