Skip to main content
Glama

Observe contract state

fresh402_contract_watch
Destructive

Reads blockchain state; the observation does not execute transactions or modify the target wallet/contract. An authorized USDC service payment is separate. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Observe code, standard proxy slots, common getters, explicitly selected storage/ABI and bounded selected events at one finalized Base address; optionally compare an owned prior snapshot. Selected single-provider evidence only; unknown controls remain unknown. $0.010000 native USDC/call on Base (eip155:8453); compatible x402 or enabled native MPP client required, no Fresh402 token for first purchase. Save proof/input and private recovery token BEFORE paying for full-response-loss protection: REST X-Fresh402-Recovery-Token; MCP params._meta['fresh402/recovery-token']. Recover originals without new RPC/debit; foreign snapshot/cursor forbidden. Provider failure/partial scan is not paid success. observation_saved=false/persistence_error: recover only, never use unsaved IDs. Prepaid needs eligible finalized all-service credits or an original explicit service-specific tariff4 grant; inspect /v3/prepaid/quote/contract_watch and /v3/prepaid/all-services. Historical Web rights unchanged; paying agents do not need their own RPC credentials. Observations30days, private financial recovery7days. Not full history, financial advice or security audit. Clients: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "chain_id": "<chain_id>",
      "address": "<address>"
    },
    "name": "fresh402_contract_watch"
  }
}

Input Schema

NameRequiredDescriptionDefault
blockNoFinalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback.finalized
readsNoAt most one unverified zero-argument view/pure ABI read with one supported static output.
slotsNoAt most one exact bytes32 storage slot; no inferred layout.
addressYes20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form.
chain_idYesBase mainnet only; returned provider chain must match.
event_topicsNoAt most one exact topic0 at this contract, bounded to the existing lookback/call limit. Dense or excessive work fails the whole paid operation; no partial success.
events_from_blockNoOptional first event block; otherwise previous snapshot block+1, or current block initially. Older than 32 blocks returns lookback_gap, without skipping to recent history.
previous_snapshotNoOptional owned snapshot_id from a successful saved contract_watch result, retained for30days. Same payer or prepaid account, chain, address and provider required. Foreign/missing IDs return404; expired IDs return410 without silently starting a new baseline.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "$schema": "https://json-schema.org/draft/2020-12/schema",
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "accounting": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "response_bytes": {
      +                  "maximum": 4194304,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "rpc_requests": {
      +                  "maximum": 18,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "scope": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "wire_response_bytes": {
      +                  "maximum": 4194304,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                }
      +              },
      +              "required": [
      +                "rpc_requests",
      +                "response_bytes",
      +                "wire_response_bytes",
      +                "scope"
      +              ],
      +              "type": "object"
      +            },
      +            "comparison": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "changes": {
      +                  "items": {},
      +                  "maxItems": 32,
      +                  "type": "array"
      +                },
      +                "status": {
      +                  "enum": [
      +                    "unknown",
      +                    "changed",
      +                    "unchanged"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "status",
      +                "changes"
      +              ],
      +              "type": "object"
      +            },
      +            "event_coverage": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "status": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "status"
      +              ],
      +              "type": "object"
      +            },
      +            "events": {
      +              "items": {},
      +              "maxItems": 100,
      +              "type": "array"
      +            },
      +            "limitations": {
      +              "items": {
      +                "maxLength": 1024,
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "observation_saved": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "persistence": {
      +              "enum": [
      +                "atomic_with_financial_delivery",
      +                "atomic_with_entitlement_delivery"
      +              ],
      +              "type": "string"
      +            },
      +            "snapshot": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "address": {
      +                  "pattern": "^0x[a-fA-F0-9]{40}$",
      +                  "type": "string"
      +                },
      +                "block": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "chain_id": {
      +                      "const": 8453,
      +                      "type": "number"
      +                    },
      +                    "finalized": {
      +                      "const": true,
      +                      "type": "boolean"
      +                    },
      +                    "hash": {
      +                      "pattern": "^0x[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "number": {
      +                      "maximum": 9007199254740991,
      +                      "minimum": 0,
      +                      "type": "integer"
      +                    },
      +                    "observed_at": {
      +                      "format": "date-time",
      +                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
      +                      "type": "string"
      +                    },
      +                    "parent_hash": {
      +                      "pattern": "^0x[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "policy": {
      +                      "const": "finalized",
      +                      "type": "string"
      +                    },
      +                    "source": {
      +                      "pattern": "^[a-z0-9_-]{3,64}$",
      +                      "type": "string"
      +                    },
      +                    "timestamp": {
      +                      "maximum": 9007199254740991,
      +                      "minimum": 0,
      +                      "type": "integer"
      +                    },
      +                    "trust": {
      +                      "maxLength": 256,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "number",
      +                    "hash",
      +                    "parent_hash",
      +                    "timestamp",
      +                    "chain_id",
      +                    "policy",
      +                    "finalized",
      +                    "source",
      +                    "observed_at",
      +                    "trust"
      +                  ],
      +                  "type": "object"
      +                },
      +                "fields": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "warnings": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "address",
      +                "block",
      +                "fields",
      +                "warnings"
      +              ],
      +              "type": "object"
      +            },
      +            "snapshot_id": {
      +              "pattern": "^s_[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            "snapshot_saved": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "tool": {
      +              "const": "fresh402_contract_watch",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "observation_saved",
      +            "snapshot_saved",
      +            "persistence",
      +            "accounting",
      +            "limitations",
      +            "tool",
      +            "snapshot_id",
      +            "snapshot",
      +            "comparison",
      +            "events",
      +            "event_coverage"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "accounting": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "response_bytes": {
      +                  "maximum": 4194304,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "rpc_requests": {
      +                  "maximum": 18,
      +                  "minimum": 1,
      +                  "type": "integer"
      +                },
      +                "scope": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "wire_response_bytes": {
      +                  "maximum": 4194304,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                }
      +              },
      +              "required": [
      +                "rpc_requests",
      +                "response_bytes",
      +                "wire_response_bytes",
      +                "scope"
      +              ],
      +              "type": "object"
      +            },
      +            "comparison": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "changes": {
      +                  "items": {},
      +                  "maxItems": 32,
      +                  "type": "array"
      +                },
      +                "status": {
      +                  "enum": [
      +                    "unknown",
      +                    "changed",
      +                    "unchanged"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "status",
      +                "changes"
      +              ],
      +              "type": "object"
      +            },
      +            "cursor_saved": {
      +              "const": false,
      +              "type": "boolean"
      +            },
      +            "event_coverage": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "status": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "status"
      +              ],
      +              "type": "object"
      +            },
      +            "events": {
      +              "items": {},
      +              "maxItems": 100,
      +              "type": "array"
      +            },
      +            "limitations": {
      +              "items": {
      +                "maxLength": 1024,
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "observation_saved": {
      +              "const": false,
      +              "type": "boolean"
      +            },
      +            "persistence": {
      +              "enum": [
      +                "atomic_with_financial_delivery",
      +                "atomic_with_entitlement_delivery"
      +              ],
      +              "type": "string"
      +            },
      +            "persistence_error": {
      +              "maxLength": 512,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "snapshot": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "address": {
      +                  "pattern": "^0x[a-fA-F0-9]{40}$",
      +                  "type": "string"
      +                },
      +                "block": {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "chain_id": {
      +                      "const": 8453,
      +                      "type": "number"
      +                    },
      +                    "finalized": {
      +                      "const": true,
      +                      "type": "boolean"
      +                    },
      +                    "hash": {
      +                      "pattern": "^0x[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "number": {
      +                      "maximum": 9007199254740991,
      +                      "minimum": 0,
      +                      "type": "integer"
      +                    },
      +                    "observed_at": {
      +                      "format": "date-time",
      +                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
      +                      "type": "string"
      +                    },
      +                    "parent_hash": {
      +                      "pattern": "^0x[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "policy": {
      +                      "const": "finalized",
      +                      "type": "string"
      +                    },
      +                    "source": {
      +                      "pattern": "^[a-z0-9_-]{3,64}$",
      +                      "type": "string"
      +                    },
      +                    "timestamp": {
      +                      "maximum": 9007199254740991,
      +                      "minimum": 0,
      +                      "type": "integer"
      +                    },
      +                    "trust": {
      +                      "maxLength": 256,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "number",
      +                    "hash",
      +                    "parent_hash",
      +                    "timestamp",
      +                    "chain_id",
      +                    "policy",
      +                    "finalized",
      +                    "source",
      +                    "observed_at",
      +                    "trust"
      +                  ],
      +                  "type": "object"
      +                },
      +                "fields": {
      +                  "additionalProperties": {},
      +                  "propertyNames": {
      +                    "type": "string"
      +                  },
      +                  "type": "object"
      +                },
      +                "warnings": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "address",
      +                "block",
      +                "fields",
      +                "warnings"
      +              ],
      +              "type": "object"
      +            },
      +            "snapshot_id": {
      +              "pattern": "^s_[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            "snapshot_saved": {
      +              "const": false,
      +              "type": "boolean"
      +            },
      +            "tool": {
      +              "const": "fresh402_contract_watch",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "observation_saved",
      +            "snapshot_saved",
      +            "persistence",
      +            "accounting",
      +            "limitations",
      +            "tool",
      +            "snapshot_id",
      +            "snapshot",
      +            "comparison",
      +            "events",
      +            "event_coverage",
      +            "cursor_saved",
      +            "persistence_error"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    {
      +      "description": "Tool error only; accompanied by isError=true.",
      +      "properties": {
      +        "error": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "retryable": {
      +          "type": "boolean"
      +        },
      +        "status": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +      "properties": {
      +        "accepts": {
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "resource": {
      +          "type": "object"
      +        },
      +        "x402Version": {
      +          "const": 2
      +        }
      +      },
      +      "required": [
      +        "x402Version",
      +        "accepts"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.",
      +  "type": "object"
      +}
  2. Added

TDQS

A3.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, it discloses that execution may charge USDC/prepaid credits, consume trial quota, and update Fresh402 records, and it explains unpaid quotes, authorization requirements, recovery tokens, provider-failure handling, idempotency, 429s, and retention periods. It also clarifies that the observation itself does not modify the target wallet/contract, so the destructiveHint=true and readOnlyHint=false annotations are explained rather than contradicted.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the opening sentences, but the rest is a sprawling semicolon-chained block mixing payment, trial, recovery, network, and retention details. Much of that material is not needed for selecting or invoking the tool, and the lack of paragraph structure makes it hard to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex paid observation tool with an output schema already available, the description covers pricing, authorization, trial constraints, snapshot retention, failure modes, recovery, and network constraints. It is complete, even over-complete, for an agent deciding whether and how to call it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents all eight parameters. The description reinforces key semantics like finalized Base, bounded selected events, and owned previous snapshots, but it adds little syntax or meaning beyond what the parameter descriptions already provide.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening states a specific verb and resource: it reads blockchain state and observes code, proxy slots, getters, selected storage/ABI, and bounded events at one finalized Base address. It is clear what the tool does, but it never names or contrasts with sibling tools such as wallet_watch or smart_diff, so sibling differentiation is left implicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives contextual boundaries such as finalized Base only, optional owned prior snapshot, and not full history, which implies when the tool applies. However, it provides no explicit when-to-use/when-not-to-use routing against alternatives; most operational guidance concerns payment, trial, and recovery rather than tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources