io.github.AutomatonColony/automaton-colony

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Screen Base smart contracts and B20 tokens: free on-chain check, paid Flash Audit over x402 (USDC).

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "automaton-colony": {
      "url": "https://colony.automatoncolony.xyz/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• check_contract_free read-only

  Free, no wallet. Observed on-chain facts about a Base address with no verdict and no score: verified source, proxy detection, admin selectors, holder concentration, and for B20 native tokens the issuer powers. Rate limited; a monthly quota applies.

  Parameters:

  • address (required) — string — Contract or B20 token address on Base mainnet (eip155:8453), 0x + 40 hex.

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

• flash_audit_terms read-only

  Returns the x402 v2 PaymentRequired document for the paid Flash Report: amount in USDC base units, network, asset, payTo and the request schema. Free. It also says how a person without a wallet can buy the report in the web store.

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

• buy_flash_audit

  Paid over x402 in USDC on Base. Without a payment in _meta["x402/payment"] it returns the PaymentRequired document (isError), followed by how a person without a wallet can buy the same report in the web store. With a valid PaymentPayload it validates, settles asynchronously and returns an orderKey to collect with collect_flash_audit. If the payment is read but does not pass (wrong amount or recipient, insufficient balance, bad signature, expired or already-used authorization), it returns the PaymentRequired document again (isError) with the x402 errorReason in its "error" field; this call charges nothing.

  Parameters:

  • targetAddress (required) — string — Contract or B20 token address on Base mainnet (eip155:8453), 0x + 40 hex.
  • language — string — Report language. Defaults to "en".

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

• collect_flash_audit read-only

  Status of an x402 order while it settles and generates; once DELIVERED, the report JSON itself. Poll every 10-15 seconds. Free.

  Parameters:

  • orderKey (required) — string

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

• contract_data_catalog read-only

  Free, no wallet. Lists the individual on-chain facts about a Base contract that can be bought one call at a time, with the price in USDC and how long each answer stays valid. Read this before paying: the bundle costs less than buying the parts.

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

• buy_contract_data

  Paid over x402 in USDC on Base, from 0.0049 per call. Unlike buy_flash_audit, the answer comes back in THIS call: there is no order to poll. A first read of an address can take up to 60s: keep the connection open. If it drops before the answer arrives, send the SAME payment again within 10 minutes: the same authorization is never charged twice. Every answer carries the block it was read at and that block's hash, so it can be re-read against the chain. Call contract_data_catalog first for the list and prices. Without a payment in _meta["x402/payment"] it returns the PaymentRequired document, followed by what can be done for free without a wallet. If the payment is read but does not pass (wrong amount or recipient, insufficient balance, bad signature, expired or already-used authorization), it returns the PaymentRequired document again (isError) with the x402 errorReason in its "error" field; this call charges nothing.

  Parameters:

  • product (required) — string — Which fact to buy. See the catalog tool.
  • targetAddress — string — Contract or token address on Base mainnet (eip155:8453). Required for every product whose catalog entry says needsTargetAddress=true.

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

Publisher website Repository

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