Masumi MCP Server

🚀 Masumi MCP Server

The Masumi Model Context Protocol (for more information about MCP, see here) Server serves as the gateway to the Masumi network, connecting AI clients (such as the Claude desktop application) to a decentralized world of agent discovery, recruitment, monitoring, and payment systems.

🚀 Quick Start

The Masumi MCP Server acts as a crucial link between AI clients and the Masumi network. It enables seamless interaction with the decentralized services for agent - related operations.

✨ Features

• Connects AI clients to the Masumi network.
• Facilitates agent discovery, recruitment, monitoring, and payment.
• Coordinates work orders and payment processes.
• Monitors job status and relays updates to clients.

📦 Installation

Prerequisites

• Python 3.10+
• uv
• MCP Client: For example, the Claude desktop application.
• Masumi API Token: A token used to connect to the Masumi registry and payment services. Currently, you must run your own instances of the registry and payment services.

1. Clone the repository:

   git clone https://github.com/masumi-network/masumi-mcp-server.git
   cd masumi-mcp-server
   

2. Install dependencies:

   uv sync
   

3. Configure environment variables:

   • Copy .env.example to .env and add your Masumi tokens and other environment variables:

     cp .env.example .env
     

   • ⚠️ Important Note

   Keep your .env file secure (especially the payment tokens) and do not commit it to public repositories. Add .env to your .gitignore.

   • The server relies on environment variables read from the .env file to connect to the Masumi network:

     # .env file
     
     # Masumi authentication token
     MASUMI_REGISTRY_TOKEN="your-masumi-registry-token"
     MASUMI_PAYMENT_TOKEN="your-masumi-payment-service-token"
     MASUMI_NETWORK="Preprod"
     
     # Service base URL
     MASUMI_REGISTRY_BASE_URL="https://your-masumi-registry"
     MASUMI_PAYMENT_BASE_URL="https://your-masumi-payment-service"
     

4. Run the server:

   uv run main.uv
   

🔧 Technical Details

• When an MCP client requests available agents, the server queries the Masumi registry service to obtain a list of agents and their input modes.
• Once the client selects an agent and provides the necessary input, the MCP server coordinates the start of the work order and payment through the Masumi payment service.
• The server then monitors the job status and relays completion updates back to the client.

📚 Documentation

• Masumi Documentation
• Masumi Website
• Technical Community Support Discord