🐴 Gulltoppr

Working · 560 ms

io.github.portdeveloper/gulltopprv0.1.2

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

Crypto & Web3

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.gulltoppr.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

chainstring, required

Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.

tx_hashstring, required

0x transaction hash.

rpc_urlstring

Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids.

Tools (12)

decode_tx

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.

read-only

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chain",
    "tx_hash"
  ],
  "properties": {
    "chain": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0
        }
      ],
      "description": "Chain alias from GET /v1/chains (for example \"ethereum\", \"base\", \"monad\", \"bsc\") or numeric EIP-155 chain id."
    },
    "rpc_url": {
      "type": "string",
      "pattern": "^https?:\\/\\/\\S+$",
      "description": "Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids."
    },
    "tx_hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "0x transaction hash."
    }
  },
  "additionalProperties": false
}

encode_call

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

read-only

Argument	Type	Description
args	array	Function arguments, in order. Pass uint values as decimal strings.
chain*	any	Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chain",
    "address",
    "function"
  ],
  "properties": {
    "args": {
      "type": "array",
      "default": [],
      "description": "Function arguments, in order. Pass uint values as decimal strings."
    },
    "chain": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0
        }
      ],
      "description": "Chain alias from GET /v1/chains (for example \"ethereum\", \"base\", \"monad\", \"bsc\") or numeric EIP-155 chain id."
    },
    "value": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Native value in wei (decimal string), for payable functions."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "0x contract address."
    },
    "rpc_url": {
      "type": "string",
      "pattern": "^https?:\\/\\/\\S+$",
      "description": "Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids."
    },
    "function": {
      "type": "string",
      "pattern": "\\S",
      "minLength": 1,
      "description": "Function name, or full signature like \"transfer(address,uint256)\" if overloaded."
    }
  },
  "additionalProperties": false
}

export_registry

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_chains

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

read-only

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search by chain id, name, alias, or native symbol; multi-word queries also match token-by-token and without whitespace."
    },
    "testnets": {
      "type": "boolean",
      "description": "When true, only testnets; when false, only mainnets."
    },
    "has_default_rpc": {
      "type": "boolean",
      "description": "When true, only chains gulltoppr can query without rpc_url."
    }
  },
  "additionalProperties": false
}

lookup_selector

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

read-only

Argument	Type	Description
selector*	string	4-byte function/error selector or 32-byte event topic0.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "selector"
  ],
  "properties": {
    "selector": {
      "type": "string",
      "pattern": "^0x([0-9a-fA-F]{8}|[0-9a-fA-F]{64})$",
      "description": "4-byte function/error selector or 32-byte event topic0."
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
args	array	Function arguments, in order. Pass uint values as decimal strings.
from*	string	The sender address (the user's wallet). No key is needed — nothing is signed.
chain*	any	Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
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.

read_contract

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

read-only

Argument	Type	Description
args	array	Function arguments, in order. Pass uint values as decimal strings.
chain*	any	Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "chain",
    "address",
    "function"
  ],
  "properties": {
    "args": {
      "type": "array",
      "default": [],
      "description": "Function arguments, in order. Pass uint values as decimal strings."
    },
    "chain": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0
        }
      ],
      "description": "Chain alias from GET /v1/chains (for example \"ethereum\", \"base\", \"monad\", \"bsc\") or numeric EIP-155 chain id."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "0x contract address."
    },
    "rpc_url": {
      "type": "string",
      "pattern": "^https?:\\/\\/\\S+$",
      "description": "Override HTTP(S) RPC URL. Required for chains with no default (e.g. local/31337) or custom EVM chain ids."
    },
    "function": {
      "type": "string",
      "pattern": "\\S",
      "minLength": 1,
      "description": "Function name, or full signature like \"transfer(address,uint256)\" if overloaded."
    }
  },
  "additionalProperties": false
}

registry_stats

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

resolve_abi

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.

read-only

Argument	Type	Description
chain*	any	Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
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.
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

resolve_name

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

read-only

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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "pattern": "\\S",
      "minLength": 1,
      "description": "An ENS/Basename (vitalik.eth, name.base.eth) or a 0x address."
    },
    "chain": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0
        }
      ],
      "description": "Chain alias from GET /v1/chains (for example \"ethereum\", \"base\", \"monad\", \"bsc\") or numeric EIP-155 chain id."
    }
  },
  "additionalProperties": false
}

runtime_metrics

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

simulate

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.

read-only

Argument	Type	Description
to	any	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).
from*	string	The sender address (the user's wallet). No key is needed — nothing is signed.
chain*	any	Chain alias from GET /v1/chains (for example "ethereum", "base", "monad", "bsc") or numeric EIP-155 chain id.
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.