MACH Base

io.github.TheAliphantPublished by GitHub account TheAliphantv1.0.3Updated Oct 25, 2026

Investigate Base transactions, check wallet funds and contracts. Read-only MCP. USDC via x402.

VerifiedStreamable HTTPWeb executableFinanceSecurity & Monitoring

Overview

AI-generated overview

A read-only MCP server for inspecting the Base chain: block numbers, gas prices, wallet and token balances, contracts, transactions and logs, paid per call inUS

What you can do
Choose the narrowest paid capability for a goal and get its price and next request, without live chain data or side effects (mach_choose). Check chain progress and gas price, and inspect blocks by number or tag. Read wallet context: native ETH balance, ERC-20 balances, a combined wallet snapshot, and the current nonce. Inspect contracts: deployed code and bytecode size, token metadata and interface signals, total supply, and ERC-20 allowances. Look up transactions by hash, receipts and confirmations, and a combined transaction context for payment timeouts or failures. Find contract events and recent ERC-20 transfers within a bounded block range, and run read-only eth_call with supplied calld
When to use it
Use it when an assistant needs to check Base chain state before or after acting: confirming a transaction was mined, investigating a payment timeout, checking whether a wallet has ETH for gas or enough USDC, or identifying a contract before interacting with it. It suits read-only investigation rather than signing or sending transactions.
Requirements
A remote streamable HTTP endpoint at api.mach.gallery; no local runtime, account or API key is declared. Each data call is paid in USDC via x402, so the client needs a way to settle those per-call payments. Network access to the endpoint is required.
Before you install
Every data tool costs USDC per call (mostly $0.005, transaction and transaction-context calls $0.008), so repeated polling spends money; mach_choose is free. The server is read-only and does not sign, grant approvals or hold funds. Results are not security audits, and onchain success does not prove a specific payment or service delivery. Contract supply data is not independently audited circulation.

Installation

In SourceWeft

  1. Open MACH Base in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.TheAliphant%2Fmach-base/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mach-base": {
      "type": "http",
      "url": "https://api.mach.gallery/mcp"
    }
  }
}

Tools

18

mach_choose

Choose a MACH Base capability

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.

Parametersgoalrequired

base_block_number

Get 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.

Takes no parameters.

base_gas_price

Get 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.

Takes no parameters.

base_wallet_balance

Check Base ETH 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.

Parametersaddressrequired

base_erc20_balance

Check Base token 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.

Parameterstokenrequiredaddressrequired

base_nonce

Get Base wallet nonce

Prepare a Base transaction: get a wallet’s current nonce without signing or broadcasting a transaction. Costs $0.005 USDC via x402.

Parametersaddressrequired

base_contract_code

Check Base contract

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.

Parametersaddressrequired

base_allowance

Check Base token 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.

Parametersownerrequiredtokenrequiredspenderrequired

base_receipt

Check Base transaction 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.

Parameterstx_hashrequired

base_logs

Query Base event 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.

Parameterstopicsaddressrequiredto_blockfrom_block

base_eth_call

Read Base contract state

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.

Parameterstorequireddatarequiredblock

base_transaction

Get 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.

Parameterstx_hashrequired

base_block

Get 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.

Parametersblock

base_transaction_context

Inspect 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.

Parameterstx_hashrequired

base_wallet_snapshot

Get 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.

Parameterstokensaddressrequired

base_total_supply

Get Base token 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.

Parameterstokenrequired

base_contract_info

Inspect Base contract

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.

Parametersaddressrequired

base_erc20_transfers

Find Base token 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.

Parameterstokenrequiredto_blockfrom_blockto_addressfrom_address

Version history

4
  1. v1.0.3LatestOct 13, 2026
  2. v1.0.2Sep 23, 2026
  3. v1.0.1Sep 22, 2026
  4. v1.0.0Sep 22, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.