Skip to main content
Glama

check_address_poisoning

Read-onlyIdempotent

chainpeek: Check a transfer recipient for address poisoning: lookalikes in the sender's history. For balance, gas and blacklist checks too use transfer_preflight; for OFAC use check_sanctions. Returns a risk (high | medium | low) for paying to: reads from's transfers of one token (default USDC) over the last 24 hours by default (about 27 minutes on Base) and finds addresses with to's first 4 and last 4 hex characters; each reason carries its evidence (tx hash, block, amount, direction). High: to was never paid and imitates an address from paid or a contact, or appears only in zero-value or dust transfers. Medium: a lookalike exists but to was paid or is a contact. Older history, other tokens and other lookalikes are not seen. Bad input is a 422, a failed read a 502 (neither charged). Typically 0.5-4 s. Price: USD 0.002. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/address-poisoning-check-api.html

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": "<chain>",
      "from": "<from>",
      "to": "<to>"
    },
    "name": "check_address_poisoning"
  }
}

Input Schema

NameRequiredDescriptionDefault
toYesThe recipient about to be paid; must differ from `from`.
fromYesThe sending wallet whose transfer history is read.
chainYesethereum, base or robinhood (Robinhood Chain, chain id 4663).
tokenNoOnly this token's transfers are read; on robinhood pass a contract address.USDC
contactsNoAddresses you trust; `to` is compared with them too, with no chain read.
lookback_sNoSeconds of history to read (default 24 hours; public nodes serve only about 27 minutes on Base). Not with `lookback_blocks`.
dust_thresholdNoIncoming transfers below this many token units are dust: default 0.01 for USDC and USDT, else off; 0 turns it off.
lookback_blocksNoInstead of `lookback_s`: the latest blocks to read; 0 checks `contacts` only.

Output Schema

NameRequiredDescriptionDefault
toNo
fromNo
riskNo
chainNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
rulesNo
tokenNo
limitsNo
historyNo
matchesNo
reasonsNo
decimalsNo
rpc_callsNo
to_historyNo
token_symbolNo
matches_totalNo
dust_thresholdNo
contacts_checkedNo
dust_threshold_rawNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed18 schema fields changed
    • removedInput schema / properties / chain / title
      Removed value: -"Chain"
    • removedInput schema / properties / contacts / default
      Removed value: -null
    • removedInput schema / properties / contacts / title
      Removed value: -"Contacts"
    • removedInput schema / properties / dust_threshold / default
      Removed value: -null
    • removedInput schema / properties / dust_threshold / title
      Removed value: -"Dust Threshold"
    • removedInput schema / properties / from / title
      Removed value: -"From"
    • removedInput schema / properties / lookback_blocks / default
      Removed value: -null
    • removedInput schema / properties / lookback_blocks / title
      Removed value: -"Lookback Blocks"
    • removedInput schema / properties / lookback_s / default
      Removed value: -null
    • removedInput schema / properties / lookback_s / title
      Removed value: -"Lookback S"
    • removedInput schema / properties / to / title
      Removed value: -"To"
    • removedInput schema / properties / token / title
      Removed value: -"Token"
    • removedInput schema / title
      Removed value: -"check_address_poisoningArguments"
    • removedOutput schema / properties / history / properties
      Removed value: -{
      -  "blocks": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "chunks": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "complete": {
      -    "type": [
      -      "boolean",
      -      "null"
      -    ]
      -  },
      -  "counterparties": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "dust": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "from_block": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "from_time": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "paid_addresses": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "read": {
      -    "type": [
      -      "boolean",
      -      "null"
      -    ]
      -  },
      -  "requested_blocks": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "requested_s": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "seconds": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "stopped": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "to_block": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "to_time": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "transfers": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "zero_value": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / limits / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / matches / items
      Removed value: -{
      -  "properties": {
      -    "address": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "dust": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "in_contacts": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "paid_by_from": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "prefix_match": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "suffix_match": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "transfers": {
      -      "items": {
      -        "properties": {
      -          "amount": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "amount_raw": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "block": {
      -            "type": [
      -              "integer",
      -              "null"
      -            ]
      -          },
      -          "direction": {
      -            "enum": [
      -              "in",
      -              "out",
      -              null
      -            ],
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "kind": {
      -            "enum": [
      -              "zero",
      -              "dust",
      -              "value",
      -              null
      -            ],
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "log_index": {
      -            "type": [
      -              "integer",
      -              "null"
      -            ]
      -          },
      -          "tx_hash": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    },
      -    "transfers_total": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "zero_value": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / reasons / items
      Removed value: -{
      -  "properties": {
      -    "code": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "evidence": {
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "message": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "severity": {
      -      "enum": [
      -        "high",
      -        "medium",
      -        "info",
      -        "ok",
      -        null
      -      ],
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / to_history / properties
      Removed value: -{
      -  "dust": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "in_contacts": {
      -    "type": [
      -      "boolean",
      -      "null"
      -    ]
      -  },
      -  "paid": {
      -    "type": [
      -      "boolean",
      -      "null"
      -    ]
      -  },
      -  "payments": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "received": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "seen": {
      -    "type": [
      -      "boolean",
      -      "null"
      -    ]
      -  },
      -  "transfers": {
      -    "items": {
      -      "properties": {
      -        "amount": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "amount_raw": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "block": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "direction": {
      -          "enum": [
      -            "in",
      -            "out",
      -            null
      -          ],
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "kind": {
      -          "enum": [
      -            "zero",
      -            "dust",
      -            "value",
      -            null
      -          ],
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "log_index": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        },
      -        "tx_hash": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "type": [
      -      "array",
      -      "null"
      -    ]
      -  },
      -  "zero_value": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
  2. Changed7 schema fields changed
    • changedInput schema / properties / contacts / description
      Previous value: -"Up to 100 addresses you trust (your address book); `to` is compared with them too, without any chain read."New value: +"Addresses you trust; `to` is compared with them too, with no chain read."
    • changedInput schema / properties / dust_threshold / description
      Previous value: -"Incoming transfers below this many token units count as dust. Default 0.01 for USDC and USDT; off for other tokens unless set; 0 turns it off."New value: +"Incoming transfers below this many token units are dust: default 0.01 for USDC and USDT, else off; 0 turns it off."
    • changedInput schema / properties / from / description
      Previous value: -"The sending wallet whose transfer history is read (0x + 40 hex)."New value: +"The sending wallet whose transfer history is read."
    • changedInput schema / properties / lookback_blocks / description
      Previous value: -"Instead of `lookback_s`: the latest blocks of history to read, in one range (0-2,000; 2,000 is about 6.7 minutes on Base at 0.2 s and 6.7 hours on Ethereum). 0 reads nothing and checks `contacts` only."New value: +"Instead of `lookback_s`: the latest blocks to read; 0 checks `contacts` only."
    • changedInput schema / properties / lookback_s / description
      Previous value: -"How many seconds of history to read (1-86,400; default 86,400, 24 hours), cut by block timestamps. Public nodes serve logs only about 8,000 blocks deep: about 27 minutes on Base at its current 0.2 s block time (the whole window on Ethereum); `history.from_time`, `history.seconds` and `history.complete` say what was read. Not with `lookback_blocks`."New value: +"Seconds of history to read (default 24 hours; public nodes serve only about 27 minutes on Base). Not with `lookback_blocks`."
    • changedInput schema / properties / to / description
      Previous value: -"The recipient about to be paid (0x + 40 hex). Must differ from `from`."New value: +"The recipient about to be paid; must differ from `from`."
    • changedInput schema / properties / token / description
      Previous value: -"USDC (default), USDT, or a token contract address. Only this token's transfers are read. On robinhood pass a contract address."New value: +"Only this token's transfers are read; on robinhood pass a contract address."
  3. Changed14 schema fields changed
    • addedInput schema / properties / lookback_blocks / anyOf
      Added value: +[
      +  {
      +    "maximum": 2000,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / lookback_blocks / default
      Previous value: -2000New value: +null
    • changedInput schema / properties / lookback_blocks / description
      Previous value: -"How many of the latest blocks of history to read (0-2,000; default 2,000, about 67 minutes on Base and 6.7 hours on Ethereum). 0 reads nothing and checks `contacts` only."New value: +"Instead of `lookback_s`: the latest blocks of history to read, in one range (0-2,000; 2,000 is about 6.7 minutes on Base at 0.2 s and 6.7 hours on Ethereum). 0 reads nothing and checks `contacts` only."
    • removedInput schema / properties / lookback_blocks / maximum
      Removed value: -2000
    • removedInput schema / properties / lookback_blocks / minimum
      Removed value: -0
    • removedInput schema / properties / lookback_blocks / type
      Removed value: -"integer"
    • addedInput schema / properties / lookback_s
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 86400,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "How many seconds of history to read (1-86,400; default 86,400, 24 hours), cut by block timestamps. Public nodes serve logs only about 8,000 blocks deep: about 27 minutes on Base at its current 0.2 s block time (the whole window on Ethereum); `history.from_time`, `history.seconds` and `history.complete` say what was read. Not with `lookback_blocks`.",
      +  "title": "Lookback S"
      +}
    • addedOutput schema / properties / history / properties / chunks
      Added value: +{
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / history / properties / from_time
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / history / properties / requested_blocks
      Added value: +{
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / history / properties / requested_s
      Added value: +{
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / history / properties / seconds
      Added value: +{
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / history / properties / stopped
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / history / properties / to_time
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  4. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources