🐴 Gulltoppr

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Resolve any EVM contract ABI (even unverified, via decompilation), read, simulate, prepare txs.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "🐴 Gulltoppr": {
      "url": "https://mcp.gulltoppr.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• list_chains read-only

  List viem-backed chain aliases and ids. Use filters to find testnets, default-RPC chains, or a named chain before resolving contracts.

  Parameters:

  • q — string — Search by chain id, name, alias, or native symbol; multi-word queries also match token-by-token and without whitespace.
  • testnets — boolean — When true, only testnets; when false, only mainnets.
  • has_default_rpc — boolean — When true, only chains gulltoppr can query without rpc_url.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• runtime_metrics read-only

  Read process-local resolver/rung/RPC counters for smoke checks and reliability dashboards.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• lookup_selector read-only

  Lookup gulltoppr-proven signatures for a 4-byte function/error selector or 32-byte event topic0. Prefer these over public 4byte guesses.

  Parameters:

  • selector (required) — string — 4-byte function/error selector or 32-byte event topic0.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• registry_stats read-only

  Read selector commons counts by proof grade and bytecode-match index size.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• export_registry read-only

  Return the CC0 selector commons as NDJSON. This can be large; prefer lookup_selector for normal agent workflows.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• resolve_abi read-only

  Resolve a contract's interface from chain + address via a fallback ladder (Etherscan → Sourcify → proxy → heimdall decompile → 4byte). Returns a compact capability manifest (read vs write functions, the 'buttons'), proxy chain, token metadata, and PROVENANCE. ALWAYS read `provenance`: a `decompiled` ABI has synthetic function names — treat it with care and confirm intent before writing. Partial, proxy, and bytecode-match results lead with a WARNING before the JSON. The compact manifest/provenance is also returned as structuredContent. Use method_q/method_kind/method_limit for large ABIs. Raw ABI is omitted from MCP output to save tokens; use REST/SDK resolve_abi with include_abi=true if needed.

  Parameters:

  • chain (required) — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
  • address (required) — string — 0x contract address.
  • rpc_url — string — Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.
  • method_q — string — Case-insensitive manifest method search across names, signatures, parameters, outputs, and hints.
  • method_kind — string — Restrict manifest methods to read, write, or all.
  • method_limit — integer — Maximum number of manifest methods to return after filtering.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• read_contract read-only

  Call a view/pure function and get the decoded result. No wallet, no cost. Rejects state-mutating functions.

  Parameters:

  • chain (required) — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
  • address (required) — string — 0x contract address.
  • function (required) — string — Function name, or full signature like "transfer(address,uint256)" if overloaded.
  • args — array — Function arguments, in order. Pass uint values as decimal strings.
  • rpc_url — string — Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• encode_call read-only

  Encode a function call to calldata (0x…) without sending anything.

  Parameters:

  • chain (required) — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
  • address (required) — string — 0x contract address.
  • function (required) — string — Function name, or full signature like "transfer(address,uint256)" if overloaded.
  • args — array — Function arguments, in order. Pass uint values as decimal strings.
  • value — string — Native value in wei (decimal string), for payable functions.
  • rpc_url — string — Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• simulate read-only

  Simulate a call and return success, gas, decoded return, and best-effort state diff / asset changes / logs. Provide a high-level call (address + function + args) or raw (to + data), never both.

  Parameters:

  • chain (required) — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
  • from (required) — string — The sender address (the user's wallet). No key is needed — nothing is signed.
  • to — Raw form: target address.
  • args — array — Function arguments, in order. Pass uint values as decimal strings.
  • data — string — Raw form: calldata (0x-prefixed hex bytes).
  • value — string — Native value in wei (decimal string), for payable functions.
  • address — string — 0x contract address.
  • rpc_url — string — Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.
  • function — string — Function name, or full signature like "transfer(address,uint256)" if overloaded.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• prepare_tx

  Prepare a contract WRITE for the user to sign. Returns an UNSIGNED transaction, its simulation, a human-readable summary, safety metadata, warnings, a configured signing deeplink, and an EIP-1193 wallet request when signing is recommended. IMPORTANT: this tool NEVER signs or broadcasts. Present the summary + simulation + warnings to the user. Only hand them the `deeplink` or `wallet_request` when `safety.signing_recommended` is true. If `safety.risk_level` is high or blocked, make that explicit; blocked means do not send.

  Parameters:

  • chain (required) — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
  • address (required) — string — 0x contract address.
  • function (required) — string — Function name, or full signature like "transfer(address,uint256)" if overloaded.
  • from (required) — string — The sender address (the user's wallet). No key is needed — nothing is signed.
  • args — array — Function arguments, in order. Pass uint values as decimal strings.
  • value — string — Native value in wei (decimal string), for payable functions.
  • rpc_url — string — Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• decode_tx read-only

  Decode what a transaction did: delegated heimdall decode plus `decoded_call` from the resolved target ABI when available. Prefer `decoded_call` for typed function/arg names, and read its provenance.

  Parameters:

  • chain (required) — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
  • tx_hash (required) — string — 0x transaction hash.
  • rpc_url — string — Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• resolve_name read-only

  Resolve an ENS/Basename to an address, or an address to its primary ENS/Basename. Pass chain=base for Basenames.

  Parameters:

  • name (required) — string — An ENS/Basename (vitalik.eth, name.base.eth) or a 0x address.
  • chain — Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.