# ownerwatch

> ownerwatch is an open-source MCP server for security. Read-only answers to who controls an EVM contract, from owners to timelocks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/imal1ice/ownerwatch-mcp
- **MCP Registry name:** io.github.imal1ice/ownerwatch-mcp
- **Categories:** [security](https://ai-powered.com/categories/security), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add ownerwatch-mcp -- uvx ownerwatch-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.

---
Source: https://ai-powered.com/mcp/ownerwatch
