Tereno on Base

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Check a Base contract, transaction or web page before you act. Free pricing, paid per call in USDC.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Tereno on Base": {
      "url": "https://www.tereno.xyz/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• tereno_catalog

  Free. The full capability catalog: what each one answers, its price tiers in USDC on Base, how long an answer stays valid, and whether it is shared or private. Read this before paying for anything.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tereno_price

  Free. Indicative price and reuse tier for one specific input, without binding a quote or revealing a wallet. Returns hit when another agent already paid to compute this and it is still fresh, partial when only the durable half survives, miss when nothing is there to reuse. The gap between those tiers is what reuse is worth.

  Parameters:

  • capability (required) — string — Capability id: token.metadata, chain.snapshot, contract.guard or prediction.evidence.
  • address — string — Base contract address, for the capabilities that take one.
  • question — string — Proposition, for prediction.evidence.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tereno_receipt

  Free. Look up what a settled invocation actually charged: capability, version, cache tier, list price, credit applied, price paid and whether it settled on chain. Use it to check that a call you or another agent paid for was billed the way it was quoted.

  Parameters:

  • invocationId (required) — string — Invocation id from a receiptUrl.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tereno_evidence_reference

  Free. Resolve an artifactId another agent handed you: producer, validity window and the exact normalized input needed to reproduce it. Supply a stable opaque installationId to participate in the cross-agent reference experiment; it is hashed, deduplicated daily and never creates payment or credit.

  Parameters:

  • artifactId (required) — string — Public Tereno artifact id received from another agent.
  • channel — string — Optional lowercase channel label, e.g. mcp or dex-bot.
  • installationId — string — Stable opaque id for this receiving installation; do not use a wallet or secret.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tereno_publish

  Free, no payment and no gas. Submit a contract bytecode fingerprint you computed yourself. Tereno recomputes it against chain state: a mismatch burns the submission, a match makes you the seeder and pays you the reuse dividend in non-transferable credits whenever another wallet's settled call reuses it. Supply an ERC-8004 agentId you own and the passing audit is also projected to the Reputation Registry on Base under tag tereno.audit. No agentId yet? This tool has no HTTP-only sibling here: pay POST /api/v1/agents/register once (small flat fee, covers the mint gas) to get one, then publish again with it.

  Parameters:

  • wallet (required) — string — Your Base wallet. Becomes the seeder and earns the reuse dividend.
  • address (required) — string — Base contract address the fingerprint is for.
  • computedAtBlock (required) — number — Block number you read the bytecode at.
  • agentId — string — Optional ERC-8004 agentId you own, as a decimal string. Ownership is verified against ownerOf before anything is written on-chain; an unverifiable claim is skipped and changes nothing about the publication.
  • bytecodeHash — string — keccak256 of the deployed bytecode you read. Omit only for an address with no code.
  • bytecodeBytes — number — Length of the deployed bytecode in bytes. Must be 0 exactly when bytecodeHash is omitted.
  • registerIfMissing — boolean — Explicit consent to be attested via a Tereno-delegated identity you already paid POST /api/v1/agents/register for. Bind it by signing <contract-address>:erc8004-register as the resource. Does not itself trigger a mint — it only unlocks reuse of one you hold.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• token_metadata

  What token is this? Read a Base token's name, symbol, decimals and total supply as one typed, cache-shared answer with block-level freshness. Paid per call with x402 on Base: $0.01 to $0.03 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

  Parameters:

  • address (required) — string — Base token contract address to read name, symbol, decimals and total supply from.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• chain_snapshot

  What is the current state of Base? Latest block number, timestamp, base fee and suggested gas fees in a single cheap call — no parameters required. Paid per call with x402 on Base: $0.002 to $0.005 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• contract_guard

  Is this Base contract safe to interact with? Check whether an address is executable code, detect common proxy and pause signals, and return a bounded action verdict. Paid per call with x402 on Base: $0.02 to $0.1 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

  Parameters:

  • address (required) — string — Base contract address to check.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prediction_evidence

  Returns current, sourced and machine-readable evidence supporting or contradicting a prediction-market proposition. Paid per call with x402 on Base: $0.01 to $0.05 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

  Parameters:

  • question (required) — string — Prediction market question or proposition.
  • market — string — Market venue identifier (e.g. polymarket, omen, kalshi). Defaults to polymarket.
  • context — object — Optional contextual metadata.
  • marketUrl — string — Optional market URL for resolution rules extraction.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• demand_pledge

  Free market-signal pledge. It earns no credit now; a bounded non-transferable credit is released only if this same wallet later settles the named capability after it exists.

  Parameters:

  • wallet (required) — string — Your Base wallet; must later be the x402 payer.
  • capability (required) — string — 2-64 character capability id, e.g. wallet-scam-classification.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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.