Skip to content
MCP server

ownerwatch

Read-only answers to who controls an EVM contract, from owners to timelocks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About ownerwatch

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

Ownership on-chain is rarely one address. ownerwatch walks the chain of control from a contract: owners, proxy upgrade admins, beacons, EIP-2535 diamonds, Safes with their signers, threshold, modules and guard, timelocks and their delay, and AccessControl and AccessManager roles. It flags EOAs, 1-of-N Safes and powers held without a timelock.

Every result is labelled a chain view, not a verdict: it shows what contract state says, not how a key is stored, and no finding is not proof of safety. A failed read comes back as an error saying no conclusion was reached rather than a clean report. Tools never sign or send anything.

A portable skill folder teaches agents when to ask the question. Default public RPCs cover eleven chains, including Ethereum, Base, Arbitrum and Polygon, or you can pass your own RPC URL. It sends addresses to the chosen RPC and to Sourcify, and optionally to a Tenderly log gateway.

Install

Run in a terminal

claude mcp add ownerwatch-mcp -- uvx ownerwatch-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ownerwatch-mcp": {
      "command": "uvx",
      "args": [
        "ownerwatch-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ownerwatch-mcp": {
      "command": "uvx",
      "args": [
        "ownerwatch-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ownerwatch-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ownerwatch-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ownerwatch-mcp": {
      "command": "uvx",
      "args": [
        "ownerwatch-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "ownerwatch-mcp": {
      "command": "uvx",
      "args": [
        "ownerwatch-mcp"
      ]
    }
  }
}

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

Configuration

  • OWNERWATCH_MCP_TIMEOUTSeconds a tool call may take, 10 to 3600 (default 240)
  • OWNERWATCH_MCP_ALLOW_PRIVATE_RPCSet to 1 to allow http:// and private or loopback RPC hosts (a local node)

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

probe_admin_surface
Report each target's control path, findings and what could not be established
check_disclosure
Check an ERC-8241 control disclosure against chain state
suggest_monitoring_config
Generate an ownerwatch YAML monitoring config

What it does

Control-path walk
Follows owners, proxy admins, Safes and timelocks from a starting address.
Disclosure checking
Compares an ERC-8241 control disclosure against chain state at a pinned block.
Monitoring config
Produces an ownerwatch YAML config that watches the contracts and everything above them.
Not-established list
Each result states what the read could not show.
Multi-chain defaults
Public RPCs for eleven chains, or your own RPC.

Good for

  • Check who can upgrade a protocol before integrating it
  • Spot a 1-of-N Safe controlling a contract
  • Verify a team's published control disclosure
  • Set up monitoring for admin changes

Pricing

Open source

Free Python package on PyPI; runs locally over stdio

ownerwatch FAQ

Does it need a key or wallet?

No. The README says no key, wallet or account, and nothing is sent on-chain.

Can it call a private node?

Only if OWNERWATCH_MCP_ALLOW_PRIVATE_RPC=1 is set; it is off by default.

What is the default timeout?

240 seconds per call, adjustable from 10 to 3600.

Does it store data?

The README says it stores nothing and has no telemetry.

Is ownerwatch free?

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

How do I add ownerwatch to Claude Code?

Run this command in your terminal: claude mcp add ownerwatch-mcp -- uvx ownerwatch-mcp

What are the best alternatives to ownerwatch?

The closest alternatives to ownerwatch are REA, AiSOC, Solana MCP by Vybe, redamon and x64dbg-mcp-server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers