ownerwatch
Read-only answers to who controls an EVM contract, from owners to timelocks
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ownerwatch-mcp": {
"command": "uvx",
"args": [
"ownerwatch-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ownerwatch-mcp": {
"command": "uvx",
"args": [
"ownerwatch-mcp"
]
}
}
}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.



