Skip to content
MCP server

Idios

Private escrow for AI agent work on Beam: verifiable delivery, worker collateral, M of N…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.3.3
Listing updated
6 days ago

About Idios

Idios is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Private escrow for AI agent work on Beam: verifiable delivery, worker collateral, M of N disputes.

Install

Run in a terminal

claude mcp add idios --env IDIOS_WALLET_PASS='<IDIOS_WALLET_PASS>' -- uvx idios-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "idios": {
      "command": "uvx",
      "args": [
        "idios-mcp-server"
      ],
      "env": {
        "IDIOS_WALLET_PASS": "<IDIOS_WALLET_PASS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "idios": {
      "command": "uvx",
      "args": [
        "idios-mcp-server"
      ],
      "env": {
        "IDIOS_WALLET_PASS": "<IDIOS_WALLET_PASS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "idios": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "idios-mcp-server"
      ],
      "env": {
        "IDIOS_WALLET_PASS": "<IDIOS_WALLET_PASS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "idios": {
      "command": "uvx",
      "args": [
        "idios-mcp-server"
      ],
      "env": {
        "IDIOS_WALLET_PASS": "<IDIOS_WALLET_PASS>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "idios": {
      "command": "uvx",
      "args": [
        "idios-mcp-server"
      ],
      "env": {
        "IDIOS_WALLET_PASS": "<IDIOS_WALLET_PASS>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • IDIOS_WALLET_PASSBeam wallet password. If unset the server prompts on stdin at startup, which fails in containers.

Pricing

Open source

Idios FAQ

Is Idios free?

Yes. Idios is open source, so you can use and self-host it for free.

How do I add Idios to Claude Code?

Run this command in your terminal: claude mcp add idios --env IDIOS_WALLET_PASS='<IDIOS_WALLET_PASS>' -- uvx idios-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers