Skip to main content
Glama

Observe wallet balances and transfers

fresh402_wallet_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. Read ETH balance snapshots and selected ERC-20-shaped Transfer events for one wallet in a completed bounded finalized page. Save the owned cursor and use a new paid operation for the next page. Not full native/internal/NFT/transaction history; provider-reported logs cannot prove completeness. $0.020000 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/wallet_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>",
      "tokens": "<tokens>"
    },
    "name": "fresh402_wallet_watch"
  }
}

Input Schema

NameRequiredDescriptionDefault
blockNoFinalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback.finalized
cursorNoOwned opaque cursor from a prior successful wallet_watch. Scope, wallet, tokens, provider and policy must match.
tokensYesOne to four selected ERC-20 contracts; no full wallet transaction history.
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.
chunk_sizeNoSingle bounded chunk; four-block maximum and no automatic retry.
from_blockNoInitial first block; cannot be supplied with cursor. Default last four finalized blocks; a gap beyond32 fails without skipping history.
max_blocksNoAt most four blocks in this paid page; default4. has_more describes a completed bounded page, not permission to charge a failed partial scan.

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"
      +            },
      +            "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"
      +            },
      +            "coverage": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "requested_to_block": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": -9007199254740991,
      +                  "type": "integer"
      +                },
      +                "selected_tokens": {
      +                  "items": {
      +                    "pattern": "^0x[a-fA-F0-9]{40}$",
      +                    "type": "string"
      +                  },
      +                  "maxItems": 4,
      +                  "minItems": 1,
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "selected_tokens",
      +                "requested_to_block"
      +              ],
      +              "type": "object"
      +            },
      +            "cursor_saved": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "events": {
      +              "items": {},
      +              "maxItems": 100,
      +              "type": "array"
      +            },
      +            "has_more": {
      +              "type": "boolean"
      +            },
      +            "interruption": {
      +              "type": "null"
      +            },
      +            "limitations": {
      +              "items": {
      +                "maxLength": 1024,
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "native_balance": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "asset": {
      +                  "const": "ETH",
      +                  "type": "string"
      +                },
      +                "meaning": {
      +                  "type": "string"
      +                },
      +                "raw": {
      +                  "pattern": "^\\d+$",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "asset",
      +                "raw",
      +                "meaning"
      +              ],
      +              "type": "object"
      +            },
      +            "next_cursor": {
      +              "pattern": "^c_[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            "observation_saved": {
      +              "const": true,
      +              "type": "boolean"
      +            },
      +            "persistence": {
      +              "enum": [
      +                "atomic_with_financial_delivery",
      +                "atomic_with_entitlement_delivery"
      +              ],
      +              "type": "string"
      +            },
      +            "snapshot_saved": {
      +              "const": false,
      +              "type": "boolean"
      +            },
      +            "state": {
      +              "enum": [
      +                "page",
      +                "complete"
      +              ],
      +              "type": "string"
      +            },
      +            "tool": {
      +              "const": "fresh402_wallet_watch",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "observation_saved",
      +            "snapshot_saved",
      +            "persistence",
      +            "accounting",
      +            "limitations",
      +            "tool",
      +            "cursor_saved",
      +            "state",
      +            "block",
      +            "next_cursor",
      +            "events",
      +            "has_more",
      +            "interruption",
      +            "native_balance",
      +            "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"
      +            },
      +            "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"
      +            },
      +            "coverage": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "requested_to_block": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": -9007199254740991,
      +                  "type": "integer"
      +                },
      +                "selected_tokens": {
      +                  "items": {
      +                    "pattern": "^0x[a-fA-F0-9]{40}$",
      +                    "type": "string"
      +                  },
      +                  "maxItems": 4,
      +                  "minItems": 1,
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "selected_tokens",
      +                "requested_to_block"
      +              ],
      +              "type": "object"
      +            },
      +            "cursor_saved": {
      +              "const": false,
      +              "type": "boolean"
      +            },
      +            "events": {
      +              "items": {},
      +              "maxItems": 100,
      +              "type": "array"
      +            },
      +            "has_more": {
      +              "type": "boolean"
      +            },
      +            "interruption": {
      +              "type": "null"
      +            },
      +            "limitations": {
      +              "items": {
      +                "maxLength": 1024,
      +                "type": "string"
      +              },
      +              "maxItems": 20,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "native_balance": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "asset": {
      +                  "const": "ETH",
      +                  "type": "string"
      +                },
      +                "meaning": {
      +                  "type": "string"
      +                },
      +                "raw": {
      +                  "pattern": "^\\d+$",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "asset",
      +                "raw",
      +                "meaning"
      +              ],
      +              "type": "object"
      +            },
      +            "next_cursor": {
      +              "pattern": "^c_[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            "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_saved": {
      +              "const": false,
      +              "type": "boolean"
      +            },
      +            "state": {
      +              "enum": [
      +                "page",
      +                "complete"
      +              ],
      +              "type": "string"
      +            },
      +            "tool": {
      +              "const": "fresh402_wallet_watch",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "observation_saved",
      +            "snapshot_saved",
      +            "persistence",
      +            "accounting",
      +            "limitations",
      +            "tool",
      +            "cursor_saved",
      +            "state",
      +            "block",
      +            "next_cursor",
      +            "events",
      +            "has_more",
      +            "interruption",
      +            "native_balance",
      +            "coverage",
      +            "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.7/5.0
Behavior5/5

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

Annotations already flag readOnlyHint=false, destructiveHint=true, and openWorldHint=true, but the description goes substantially further: it explains that execution charges USDC or prepaid credits, consumes trial quota and mutates Fresh402 records; that a call without credentials returns an unpaid quote instead of executing; that provider failure or a partial scan is not paid success; and it gives exact retention windows and a recovery mechanism. The 'observation does not execute transactions or modify the target wallet/contract' clause is consistent with destructiveHint=true, since the destructive surface is billing and records, not the observed chain.

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 text is a dense run-on block that mixes purpose, pricing, trial mechanics, recovery tokens, two payment networks with CAIP-2 identifiers, retention policy, disclaimers, and documentation links, with the actual tool purpose appearing only around the fifth sentence. Individual clauses are load-bearing for billing safety, but they are not organized into scannable sections and the front-loading is wrong for a tool-selection decision.

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

Completeness4/5

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

For a paid, multi-network, paginated observation tool with an output schema and a fully documented input schema, the description covers the hard parts: authorization prerequisites, unpaid-quote fallback, cursor discipline, partial-scan handling, recovery capability, and rate-limit behavior. The notable omission is any statement of how this tool relates to its siblings, forcing the agent to guess between several similarly named observation tools.

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?

With schema description coverage at 100% and per-field descriptions covering cursor scoping, const-pinned block/chunk_size/chain_id, and address checksums, the schema already carries nearly all parameter meaning. The description adds real value only for cursors ('Save the owned cursor'; 'foreign snapshot/cursor forbidden') and for the scope of the tokens array, so it sits at the baseline rather than above it.

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 description contains a specific, concrete statement of scope: 'Read ETH balance snapshots and selected ERC-20-shaped Transfer events for one wallet in a completed bounded finalized page,' plus an explicit exclusion ('Not full native/internal/NFT/transaction history'). It never names a sibling such as fresh402_contract_watch to disambiguate, and the actual purpose is buried after four sentences of billing preamble, so an agent must read deep to find it.

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?

Operational preconditions are unusually explicit (prior spending authorization, trial key plus persisted Idempotency-Key, exact replay of tool/input/key, 'Exhaustion never authorizes a charge') and pagination behavior is spelled out ('use a new paid operation for the next page'). What is missing is selection guidance: nothing says when to choose this over fresh402_contract_watch, fresh402_onchain_evidence_brief, or the other observation tools, so the agent must infer it from the sibling names.

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