# MACH Base [Verified owner] [Health: Active]

**Category:** 📊 Data Platforms  
**Repository:** https://api.mach.gallery/mcp  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mach-base

## Description
16 paid Base mainnet data tools for autonomous agents over Streamable HTTP MCP. Pay per call with USDC via x402; no account, API key or subscription required.

## Tools
Capabilities this server exposes over MCP:

- **mach_choose** — 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.
- **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.
- **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.
- **base_wallet_balance** — 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.
- **base_erc20_balance** — 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.
- **base_nonce** — Prepare a Base transaction: get a wallet’s current nonce without signing or broadcasting a transaction. Costs $0.005 USDC via x402.
- **base_contract_code** — 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.
- **base_allowance** — 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.
- **base_receipt** — 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.
- **base_logs** — 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.
- **base_eth_call** — 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.
- **base_transaction** — 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.
- **base_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.
- **base_transaction_context** — 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.
- **base_wallet_snapshot** — 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.
- **base_total_supply** — 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.
- **base_contract_info** — 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.
- **base_erc20_transfers** — 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.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: medium). Install path inferred — verify against the README before running it. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "mach-base": {
    "url": "https://api.mach.gallery/mcp"
  }
}
```

## Documentation

## What MACH Base MCP server does

MACH Base MCP server gives AI agents access to live Base mainnet data through MCP tools. It is intended for agents that need current network, wallet, token, contract, block, or transaction information.

The service includes 16 paid tools. Most calls cost $0.005 USDC through x402; the transaction lookup tool costs $0.008 USDC.

## How it works

Agents connect to the endpoint at `https://api.mach.gallery/mcp` using Streamable HTTP MCP. They select a tool and provide the relevant Base address, token address, transaction hash, block identifier, event filters, or contract call parameters. The service queries live Base mainnet data and returns the requested result.

Payment is handled per call with USDC through x402. The material does not specify a wallet setup, payment client configuration, network for settlement, or retry behavior, so those details should be verified before deployment.

## Setup and configuration

Configure an MCP-compatible client to use the Streamable HTTP endpoint:

`https://api.mach.gallery/mcp`

No environment variables, API keys, user account, or subscription are listed as required. The calling environment must still support the service’s x402 payment flow and provide whatever payment details that flow requires. Exact client configuration varies by MCP host and is not provided here.

## Tools and capabilities

The MACH Base MCP server provides tools for:

- Reading the current Base block number and gas price.
- Checking native ETH balances, ERC-20 balances, nonces, and ERC-20 allowances.
- Determining whether an address contains deployed contract bytecode.
- Looking up transactions, receipts, confirmation depth, and block headers with transaction hashes.
- Running read-only `eth_call` requests at a selected block tag.
- Filtering bounded contract logs by address, topics, and block range.
- Reading native ETH and up to 10 caller-supplied ERC-20 balances in one wallet snapshot.
- Reading ERC-20 or ERC-721 total supply.
- Inspecting contract bytecode, best-effort token metadata, and common token interfaces.
- Querying bounded ERC-20 Transfer events with optional sender and recipient filters.

The wallet and token tools operate on Base addresses and contracts. Event and log queries are bounded by the filters supplied to the tool, including block ranges where supported.

## Limitations and notes

MACH Base MCP server is described as a data access service for Base mainnet.

Every tool call is paid, so automated workflows should account for per-request USDC costs. Most calls have the same listed price, while `base_transaction` costs more.

Results are live reads at request time. Contract metadata is best effort, and `base_contract_info` should not be treated as a complete token verification or indexing service.

_Full upstream README: https://allmcps.com/mcp/mach-base/readme_