T402 v2.8.0—Stellar support + 39 packages across 45 networks→
SDKsGoMCP Server

Go MCP Server

The Go SDK includes an MCP (Model Context Protocol) server for AI agent integration, enabling language models to make stablecoin payments and check balances across EVM networks.

Installation

go install github.com/t402-io/t402/sdks/go/cmd/t402-mcp@latest

Features

  • 6 tools for AI agents (balance, payments, bridging)
  • Multi-network EVM support (Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, Ink, Berachain, Unichain)
  • Demo mode for testing without real transactions
  • Gasless payments via ERC-4337 bundler/paymaster
  • USDT0 bridging via LayerZero OFT

MCP Tools

ToolDescription
t402/getBalanceGet native and token balances for an address on a specific network
t402/getAllBalancesGet balances across all supported EVM networks
t402/paySend stablecoin payment (USDC, USDT, USDT0)
t402/payGaslessSend gasless payment via ERC-4337
t402/getBridgeFeeGet bridge fee estimate for cross-chain USDT0 transfer
t402/bridgeExecute cross-chain USDT0 bridge via LayerZero

Claude Desktop Setup

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "t402": {
      "command": "t402-mcp",
      "env": {
        "T402_PRIVATE_KEY": "0x...",
        "T402_DEMO_MODE": "true"
      }
    }
  }
}

Environment Variables

VariableDescriptionRequired
T402_PRIVATE_KEYHex wallet private key (0x…)Yes
T402_DEMO_MODESet to "true" to simulate transactionsNo
T402_BUNDLER_URLERC-4337 bundler endpoint for gasless paymentsNo
T402_PAYMASTER_URLERC-4337 paymaster endpointNo
T402_RPC_ETHEREUMCustom RPC URL for EthereumNo
T402_RPC_BASECustom RPC URL for BaseNo
T402_RPC_ARBITRUMCustom RPC URL for ArbitrumNo

Custom RPC URLs follow the pattern T402_RPC_<NETWORK> where <NETWORK> is the uppercase chain name.

Supported Networks

NetworkTokens
EthereumUSDC, USDT, USDT0
BaseUSDC, USDT0
ArbitrumUSDC, USDT, USDT0
OptimismUSDC, USDT
PolygonUSDC, USDT
AvalancheUSDC, USDT
InkUSDT0
BerachainUSDT0
UnichainUSDT0

Programmatic Usage

Use the MCP server as a library in your Go application:

package main
 
import (
    "context"
    "github.com/t402-io/t402/sdks/go/mcp"
)
 
func main() {
    config := &mcp.ServerConfig{
        PrivateKey: "0x...",
        DemoMode:   true,
        RPCURLs: map[string]string{
            "ethereum": "https://eth.llamarpc.com",
            "base":     "https://mainnet.base.org",
        },
    }
 
    server := mcp.NewServer(config)
 
    ctx := context.Background()
    server.Run(ctx)
}

Configuration from Environment

// LoadConfigFromEnv reads T402_PRIVATE_KEY, T402_DEMO_MODE,
// T402_BUNDLER_URL, T402_PAYMASTER_URL, and T402_RPC_* variables.
config := mcp.LoadConfigFromEnv()
server := mcp.NewServer(config)

Tool Details

t402/getBalance

Get token balances for a specific address and network.

Input:

{
  "address": "0x1234...",
  "network": "base"
}

Output:

{
  "network": "base",
  "native": { "token": "ETH", "balance": "0.15", "raw": "150000000000000000" },
  "tokens": [
    { "token": "USDC", "balance": "100.50", "raw": "100500000" },
    { "token": "USDT0", "balance": "50.00", "raw": "50000000" }
  ]
}

t402/pay

Send a stablecoin payment.

Input:

{
  "to": "0xRecipient...",
  "amount": "10.00",
  "token": "USDC",
  "network": "base"
}

Output:

{
  "txHash": "0xabc...",
  "from": "0xSender...",
  "to": "0xRecipient...",
  "amount": "10.00",
  "token": "USDC",
  "network": "base",
  "explorerUrl": "https://basescan.org/tx/0xabc..."
}

t402/bridge

Execute a cross-chain USDT0 bridge via LayerZero.

Input:

{
  "fromChain": "arbitrum",
  "toChain": "base",
  "amount": "100.00",
  "recipient": "0x..."
}

Output:

{
  "txHash": "0xdef...",
  "messageGuid": "0x...",
  "fromChain": "arbitrum",
  "toChain": "base",
  "amount": "100.00",
  "explorerUrl": "https://arbiscan.io/tx/0xdef...",
  "trackingUrl": "https://scan.layerzero-api.com/v1/...",
  "estimatedTime": 300
}

Demo Mode

When T402_DEMO_MODE=true, the server simulates all transactions without submitting them to the blockchain. This is useful for testing AI agent workflows without spending real funds. Demo mode responses include "demoMode": true in the output.

Docker

FROM golang:1.24-alpine
 
RUN go install github.com/t402-io/t402/sdks/go/cmd/t402-mcp@latest
 
ENTRYPOINT ["t402-mcp"]
docker build -t t402-mcp .
docker run -it -e T402_DEMO_MODE=true t402-mcp

Related

FacilitatorAP2 Integration