iExec MCP Server

iExec MCP Server

A Model Context Protocol (MCP) compatible server to interact with the iExec protocol — built for Claude, agents, and AI tooling.

1. Wallet Setup

Prerequisites:

• Node.js (version 18 or higher)
• npm (version 9 or higher)

Option 1: Create a new wallet with iExec

npm install -g iexec
iexec wallet create --unencrypted

Find your wallet at:

• Linux: ~/.ethereum/keystore/wallet.json
• macOS: ~/Library/Ethereum/keystore/wallet.json
• Windows: %APPDATA%/Ethereum/keystore/wallet.json

Option 2: Use an existing private key

• Create a wallet.json:

  mkdir -p ./my-wallet
  echo '{"privateKey":"0xYOUR_PRIVATE_KEY"}' > ./my-wallet/wallet.json
  

• Or use your raw private key directly in Claude configuration.

Important: All sensitive configuration (PRIVATE_KEY_PATH or PRIVATE_KEY) is used only at the local MCP server level and is never transmitted to Claude or any other AI model. This information remains strictly confidential on your local machine.

2. Getting Started

Complete the Wallet Setup above, then choose your preferred installation method:

3. Method A: NPX Configuration for Claude Desktop

Prerequisites:

• Node.js (version 18 or higher)
• npm (version 9 or higher)
• Claude Desktop

Setup Steps:

1. Open Claude Desktop configuration:

   • Open Claude Desktop → Developer > Edit Config

2. Add configuration to claude_desktop_config.json:

   With wallet file (from Section 1):

   {
     "mcpServers": {
       "iexec-mcp-server": {
         "command": "npx",
         "args": ["-y", "@iexec/mcp-server@latest"],
         "env": {
           "PRIVATE_KEY_PATH": "/ABSOLUTE/PATH/TO/YOUR/KEYSTORE/wallet.json"
         }
       }
     }
   }
   

   With direct private key:

   {
     "mcpServers": {
       "iexec-mcp-server": {
         "command": "npx",
         "args": ["-y", "@iexec/mcp-server@latest"],
         "env": {
           "PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
         }
       }
     }
   }
   

3. Restart Claude Desktop - You should see a plug icon for iexec-mcp-server

4. Method B: Claude Code CLI Setup

Prerequisites:

• Node.js (version 18 or higher)
• npm (version 9 or higher)

Setup Steps:

1. Install Claude Code CLI:

   npm install -g @anthropic-ai/claude-code
   

2. Add iExec MCP server:

   With wallet file (from Section 1):

   claude mcp add iexec-mcp --env PRIVATE_KEY_PATH=/ABSOLUTE/PATH/TO/YOUR/KEYSTORE/wallet.json -- npx @iexec/mcp-server@latest iexec-mcp
   

   With direct private key:

   claude mcp add iexec-mcp --env PRIVATE_KEY=0xYOUR_PRIVATE_KEY -- npx @iexec/mcp-server@latest iexec-mcp
   

3. Run Claude:

   claude
   

5. Method C: Local Node.js Setup

Prerequisites:

• Node.js (version 18 or higher)
• npm (version 9 or higher)
• Git
• Claude Desktop

Setup Steps:

5.1. Clone, Install, and Build

git clone https://github.com/iexecBlockchainComputing/iexec-mcp-server.git
cd iexec-mcp-server
npm install
npm run build

5.2. Integrate with Claude Desktop

1. Open Claude Desktop configuration:

   • Open Claude Desktop → Developer > Edit Config

2. Add configuration to claude_desktop_config.json:

   With wallet file (from Section 1):

   {
     "mcpServers": {
       "iexec-mcp-server": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO-IEXEC-MCP-SERVER-REPO/build/index.js"],
         "env": {
           "PRIVATE_KEY_PATH": "/ABSOLUTE/PATH/TO/wallet.json"
         }
       }
     }