Kleros

You run an MCP server that gathers complete Kleros dispute data across multiple chains, including meta-evidence, evidence submissions, and IPFS content. This enables you to serve rich dispute information to clients and tools with fast, secure access over HTTP or local streams.

How to use

You can access dispute data from the Kleros MCP Server through its HTTP endpoint or by connecting via Claude Desktop using a custom connector. The HTTP option provides a centralized URL that you can query to retrieve structured dispute data, while Claude Desktop lets you integrate the data retrieval directly into your workflow for easy, interactive exploration.

How to install

Prerequisites: Install Node.js 18.x or higher and a package manager such as npm or yarn.

Local development steps:

# 1. Clone the MCP server repository
# Replace with your actual repository URL
git clone <your-repo>
cd kleros-mcp-server

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Start the server
npm start

# 5. Health check
curl http://localhost:8080/health

Deployment and hosting

You can deploy to Fly.io to host the MCP server in the cloud. The following steps guide you through login, creating the app, building, deploying, and monitoring the deployment.

Fly.io deployment steps:

# Install Fly CLI
curl -L https://fly.io/install.sh | sh

# Login to Fly
fly auth login

# Create the app (adjust the app name if needed)
fly apps create kleros-mcp-server-new

# Build and deploy
npm run build
fly deploy

# Check status and logs
fly status
fly logs

Claude Desktop integration

To use the MCP server data in Claude Desktop, add a custom connector so you can access Kleros dispute data directly from Claude.

Easy Setup (Recommended)

1. Open Claude Desktop Settings. Click Settings in the sidebar.

2. Go to Connectors. Navigate to Settings → Connectors.

3. Add Custom Connector. Click "Add custom connector". Enter a name: "Kleros Court". Paste the URL: https://kleros-mcp-server-new.fly.dev/mcp. Click "Add".

4. Start Using. The Kleros Court tool will now be available in Claude Desktop. Try: Get dispute data for dispute ID 481 on Gnosis Chain.

Alternative Configuration File Method. Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kleros": {
      "url": "https://kleros-mcp-server-new.fly.dev/mcp"
    }
  }
}

MCP Tool

The MCP tool get_dispute_data retrieves comprehensive dispute data from Kleros including meta-evidence and evidence submissions.

Security and reliability

The server is designed to be fast and secure with DNS rebinding protection and proper CORS configuration. It includes parallel IPFS content retrieval with error handling and session management for the transport layer.

Available tools

get_dispute_data

Retrieves comprehensive dispute data for a given dispute ID and chain, including meta-evidence and evidence submissions.