MACH Base
Investigate Base transactions, check wallet funds and contracts. Read-only MCP. USDC via x402.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mach-base": {
"url": "https://api.mach.gallery/mcp"
}
}
}Remote endpoints
https://api.mach.gallery/mcpstreamable-httpWhat it can do
Tool inventory
Tools (18)
🟢mach_choose(goal)
Free decision layer: map an agent goal to the narrowest paid MACH Base capability, exact price, expected result fields and exact next request. Returns no live chain data and has no side effects.
Input Schema
{
"type": "object",
"properties": {
"goal": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "The job or outcome the agent needs from Base mainnet."
}
},
"required": [
"goal"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_block_number
Check Base chain progress: return the latest mainnet block number for freshness checks and polling. This is not transaction confirmation. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_gas_price
Check the current Base gas price in wei before estimating transaction fees. The quote alone is not the total transaction cost. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_wallet_balance(address)
Check whether a Base wallet has native ETH available for gas: return its balance in wei. Read-only; no wallet access or signing. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "20-byte 0x-prefixed EVM address on Base mainnet."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_erc20_balance(token, address)
Check a wallet’s USDC or ERC-20 balance on Base: return raw token units for a specified token contract and wallet address. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "20-byte 0x-prefixed EVM address on Base mainnet."
},
"address": {
"$ref": "#/properties/token"
}
},
"required": [
"token",
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_nonce(address)
Prepare a Base transaction: get a wallet’s current nonce without signing or broadcasting a transaction. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "20-byte 0x-prefixed EVM address on Base mainnet."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_contract_code(address)
Tell a Base contract address from an externally owned account: return whether code is deployed and its bytecode size. Not a security audit. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "20-byte 0x-prefixed EVM address on Base mainnet."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_allowance(token, owner, spender)
Check a Base token approval before an agent acts: return the ERC-20 allowance for one token, owner and spender. Does not grant approval. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 or token contract address on Base mainnet."
},
"owner": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 token owner address on Base mainnet."
},
"spender": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 spender address whose allowance is being checked."
}
},
"required": [
"token",
"owner",
"spender"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_receipt(tx_hash)
Check whether a Base transaction was mined and succeeded: return receipt status and confirmations. This does not prove the correct payee, token amount or service delivery. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"tx_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "32-byte 0x-prefixed Base transaction hash."
}
},
"required": [
"tx_hash"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_logs(address, from_block, to_block, topics)
Find Base smart-contract events in a bounded block range: return onchain logs filtered by contract address and optional topics. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Smart-contract address on Base mainnet."
},
"from_block": {
"type": "integer",
"minimum": 0,
"description": "First Base block to include in the log query."
},
"to_block": {
"type": "integer",
"minimum": 0,
"description": "Last Base block to include in the log query."
},
"topics": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"maxItems": 4,
"description": "Up to four Ethereum log topics; null keeps a topic position as a wildcard."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_eth_call(to, data, block)
Read Base contract state without broadcasting a transaction: run eth_call with supplied calldata and return the raw response. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Smart-contract address on Base mainnet."
},
"data": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]*$",
"maxLength": 32770,
"description": "0x-prefixed ABI calldata for a read-only eth_call."
},
"block": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"minimum": 0
}
],
"description": "Base block selector: block number or tag such as latest, safe, finalized, pending or earliest."
}
},
"required": [
"to",
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_transaction(tx_hash)
Inspect a Base transaction by hash: retrieve sender, recipient, value, calldata and transaction fields. Use Transaction Context for receipt and confirmation status. Costs $0.008 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"tx_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "32-byte 0x-prefixed Base transaction hash."
}
},
"required": [
"tx_hash"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_block(block)
Inspect a Base block by number or tag: retrieve its header and transaction hashes to investigate chain activity. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"block": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"minimum": 0
}
],
"description": "Base block selector: block number or tag such as latest, safe, finalized, pending or earliest."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_transaction_context(tx_hash)
Investigate a Base payment timeout or failed transaction with transaction, receipt, gas and fee context. Onchain success is not proof that a specific USDC obligation or service delivery was met. Costs $0.008 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"tx_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$",
"description": "32-byte 0x-prefixed Base transaction hash."
}
},
"required": [
"tx_hash"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_wallet_snapshot(address, tokens)
Check a Base wallet’s funding context in one read: return native ETH and balances for up to ten specified ERC-20 contracts. No signing or custody. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Wallet or account address on Base mainnet."
},
"tokens": {
"type": "array",
"items": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 or token contract address on Base mainnet."
},
"maxItems": 10,
"description": "Up to ten token contract addresses whose balances should be included."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_total_supply(token)
Check a Base ERC-20 or ERC-721 contract’s reported total supply. Contract data is not independently audited circulation. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 or token contract address on Base mainnet."
}
},
"required": [
"token"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_contract_info(address)
Identify a Base contract before interacting: inspect bytecode size, available token metadata and common interface signals. Not a security audit. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Smart-contract address on Base mainnet."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢base_erc20_transfers(token, from_address, to_address, from_block, to_block)
Find recent ERC-20 Transfer events on Base, optionally filtered by sender or recipient wallet. Results cover only the queried block window. Costs $0.005 USDC via x402.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "ERC-20 or token contract address on Base mainnet."
},
"from_address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Optional sender wallet to filter ERC-20 transfers."
},
"to_address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "Optional recipient wallet to filter ERC-20 transfers."
},
"from_block": {
"type": "integer",
"minimum": 0,
"description": "First Base block to include in the transfer query."
},
"to_block": {
"type": "integer",
"minimum": 0,
"description": "Last Base block to include in the transfer query."
}
},
"required": [
"token"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence