# Baton

> CLI toolkit and MCP server for the Tempo blockchain. Provides 126 tools for token transfers, DEX trading, account management, and more.

- **Type:** MCP server
- **Install:** `agentstack add mcp-augmnt-baton`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [augmnt](https://agentstack.voostack.com/s/augmnt)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [augmnt](https://github.com/augmnt)
- **Source:** https://github.com/augmnt/baton

## Install

```sh
agentstack add mcp-augmnt-baton
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Baton

CLI toolkit and MCP server for the Tempo blockchain.

## Features

- **126 MCP Tools** - Complete blockchain operations accessible via Model Context Protocol
- **CLI Interface** - Command-line interface for all operations
- **TIP-20 Token Operations** - Transfer, approve, mint, burn, and role management
- **DEX Integration** - Swap, limit orders, and price calculations
- **Account Management** - Balances, nonces, fee tokens
- **Access Key Management** - Authorize and revoke access keys
- **Policy System** - Create and manage transfer policies (TIP-403)
- **Rewards Distribution** - Claim and distribute rewards
- **Testnet Faucet** - Fund addresses on testnet

## Installation

### CLI Usage (Recommended)

Install globally to use the `baton` command anywhere:

```bash
npm install -g @augmnt-sh/baton
```

Or run directly with npx (no installation required):

```bash
npx @augmnt-sh/baton 
```

### Programmatic Usage

Install as a project dependency:

```bash
npm install @augmnt-sh/baton
```

### From Source

```bash
git clone https://github.com/augmnt/baton.git
cd baton
npm install
npm run build
```

## Quick Start

The fastest way to get started is using the interactive setup wizard:

```bash
baton init
```

This will guide you through:
- Creating a new wallet or importing an existing one
- Choosing your network (testnet or mainnet)
- Saving your configuration to `.env`
- Optionally funding your wallet from the testnet faucet

### Example Setup Flow

```
$ baton init

██████╗  █████╗ ████████╗ ██████╗ ███╗   ██╗
██╔══██╗██╔══██╗╚══██╔══╝██╔═══██╗████╗  ██║
██████╔╝███████║   ██║   ██║   ██║██╔██╗ ██║
██╔══██╗██╔══██║   ██║   ██║   ██║██║╚██╗██║
██████╔╝██║  ██║   ██║   ╚██████╔╝██║ ╚████║
╚═════╝ ╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═══╝

  Welcome to Baton Setup

? How would you like to set up your wallet?
  ❯ Create a new wallet
    Import existing wallet (private key)
    Import from mnemonic phrase

? Generate recovery phrase (mnemonic)? Yes

✓ Wallet generated successfully!

  Address:     0x742d35Cc6634C0532925a3b844Bc454e4438f44e
  Mnemonic:    word1 word2 word3 ... word12

  ⚠️  IMPORTANT: Write down your mnemonic phrase and store it safely!

? Which network would you like to use?
  ❯ Testnet (recommended for getting started)
    Mainnet

? Save configuration to .env file? Yes
✓ Configuration saved to .env

? Fund wallet from testnet faucet? Yes
✓ Funded successfully!

🚀 You're all set!
```

### Updating Configuration

To update your configuration later:

```bash
# Interactive configuration menu
baton config

# Or use specific commands:
baton config show          # View current config
baton config set-key       # Update private key (secure input)
baton config set-network   # Change network
```

**Security Note:** The `set-key` command uses secure password-style input - your private key is never visible on screen or saved to shell history.

---

## Configuration

### Environment Variables

Baton uses the following environment variables:

| Variable | Required | Description |
|----------|----------|-------------|
| `TEMPO_PRIVATE_KEY` | For write ops | Private key for signing transactions |
| `TEMPO_RPC_URL` | No | Custom RPC endpoint (defaults to Tempo testnet) |
| `TEMPO_EXPLORER_URL` | No | Custom block explorer URL |
| `TEMPO_NETWORK` | No | `mainnet` or `testnet` (default: testnet) |

### Configuration Methods

**Option 1: MCP Server Config (Recommended for Claude)**

Pass environment variables directly when adding the MCP server:
```bash
claude mcp add baton -e TEMPO_PRIVATE_KEY=0x... -- npx @augmnt-sh/baton mcp
```

This is the most secure method as the key is stored in Claude's MCP configuration and not exposed in shell history or environment.

**Option 2: Shell Profile**

Add to `~/.zshrc` or `~/.bashrc`:
```bash
export TEMPO_PRIVATE_KEY=0x...
export TEMPO_NETWORK=testnet
```

**Option 3: .env File**

Create a `.env` file in the working directory:
```bash
TEMPO_PRIVATE_KEY=0x...
TEMPO_RPC_URL=https://rpc.moderato.tempo.xyz
TEMPO_NETWORK=testnet
```

Note: For MCP servers, the `.env` file must be in the directory where Claude is running (your project directory), not the baton installation directory.

## CLI Usage

### Setup Commands

```bash
# Interactive setup wizard (recommended for new users)
baton init

# Configuration management
baton config              # Interactive config menu
baton config show         # View current configuration
baton config set-key      # Update private key (secure input)
baton config set-network  # Change network (mainnet/testnet)
```

### Wallet Operations

```bash
# Generate a new wallet
baton wallet new

# Generate with mnemonic
baton wallet new --mnemonic

# Derive address from private key
baton wallet derive 

# Derive from mnemonic
baton wallet from-mnemonic "word1 word2 ..."
```

### Account Operations

```bash
# Get all balances
baton balances 

# Get specific token balance
baton account balance  --token 

# Get account info
baton account info 

# Get nonce
baton account nonce 
```

### Token Operations

```bash
# Get token info
baton token info 

# Transfer tokens
baton token transfer   

# Transfer with memo
baton token transfer    --memo "Payment for services"

# Approve spender
baton token approve   

# Get allowance
baton token allowance   

# Mint tokens (requires MINTER_ROLE)
baton token mint   

# Burn tokens
baton token burn  
```

### DEX Operations

```bash
# Get swap quote
baton dex quote   

# Execute swap
baton dex swap   

# Place limit order
baton dex order    --buy
baton dex order    --sell

# Cancel order
baton dex cancel 

# Get order info
baton dex order-info 

# Price utilities
baton dex price --tick 100
baton dex price --price 1.01
```

### Chain Operations

```bash
# Get chain info
baton chain info

# Get block number
baton chain block-number

# Get block
baton chain block 

# Get transaction
baton chain tx 
```

### Faucet (Testnet)

```bash
# Fund address
baton faucet fund 

# Check faucet status
baton faucet status

# Check cooldown
baton faucet cooldown 
```

### Global Options

```bash
# Use testnet
baton --network testnet 

# Use custom RPC
baton --rpc https://custom-rpc.example.com 

# JSON output
baton  -o json
```

## MCP Server

### Starting the Server

```bash
baton mcp
```

### Integration with Claude Code

Basic setup (read-only operations):
```bash
claude mcp add baton -- npx @augmnt-sh/baton mcp
```

With private key for write operations:
```bash
claude mcp add baton -e TEMPO_PRIVATE_KEY=0x... -- npx @augmnt-sh/baton mcp
```

For testnet:
```bash
claude mcp add baton -e TEMPO_NETWORK=testnet -e TEMPO_PRIVATE_KEY=0x... -- npx @augmnt-sh/baton mcp
```

To update configuration, remove and re-add:
```bash
claude mcp remove baton
claude mcp add baton -e TEMPO_PRIVATE_KEY=0x... -- npx @augmnt-sh/baton mcp
```

User-level (available in all projects):
```bash
claude mcp add -s user baton -e TEMPO_PRIVATE_KEY=0x... -- npx @augmnt-sh/baton mcp
```

### Integration with Claude Desktop

Add the following to your Claude Desktop configuration file:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "baton": {
      "command": "node",
      "args": ["/path/to/baton/dist/src/mcp-server.js"],
      "env": {
        "TEMPO_NETWORK": "testnet",
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}
```

Or if installed globally via npm:

```json
{
  "mcpServers": {
    "baton": {
      "command": "npx",
      "args": ["@augmnt-sh/baton", "mcp"],
      "env": {
        "TEMPO_NETWORK": "testnet"
      }
    }
  }
}
```

### Available Tools

The MCP server provides 126 tools organized by domain:

| Domain | Tools | Description |
|--------|-------|-------------|
| Chain | 5 | Block and transaction queries |
| Wallet | 6 | Wallet generation and derivation |
| Account | 13 | Balance and account info |
| Token | 14 | TIP-20 token operations |
| DEX | 10 | Swap and order management |
| Fees | 9 | Fee token management |
| Fee AMM | 7 | Fee liquidity operations |
| Keychain | 11 | Access key management |
| Policy | 8 | Transfer policy management |
| Rewards | 10 | Rewards distribution |
| History | 7 | Transfer history |
| Faucet | 8 | Testnet faucet |
| Contracts | 8 | Generic contract operations |
| Utils | 10 | Utility functions |

### Resources

- `tempo://tokens/known` - Known token addresses
- `tempo://contracts/addresses` - Contract addresses
- `tempo://contracts/abis/tip20` - TIP-20 ABI
- `tempo://config/network` - Current network config

### Prompts

- `transfer-tokens` - Guided token transfer workflow
- `swap-tokens` - Guided swap workflow
- `check-account` - Complete account overview
- `new-wallet` - Generate and fund new wallet

## Programmatic Usage

```typescript
import {
  generateWallet,
  getBalances,
  transfer,
  getSwapQuote,
  swap,
} from '@augmnt-sh/baton'

// Generate wallet
const wallet = generateWallet()
console.log(wallet.address)

// Get balances
const balances = await getBalances('0x...')

// Transfer tokens
const result = await transfer({
  token: '0x20c0000000000000000000000000000000000001',
  to: '0x...',
  amount: 100000000n, // 100 tokens (6 decimals)
})

// Swap tokens
const quote = await getSwapQuote({
  tokenIn: '0x20c0000000000000000000000000000000000000',
  tokenOut: '0x20c0000000000000000000000000000000000001',
  amountIn: 100000000n,
})

const swapResult = await swap({
  tokenIn: '0x20c0000000000000000000000000000000000000',
  tokenOut: '0x20c0000000000000000000000000000000000001',
  amountIn: 100000000n,
})
```

## Key Concepts

### 6 Decimal Places

All TIP-20 tokens use 6 decimal places. Amounts in the CLI are human-readable:

```bash
# Transfer 100.5 tokens
baton token transfer   100.5
```

In code, use the smallest unit:

```typescript
import { parseAmount, formatAmount } from '@augmnt-sh/baton'

const amount = parseAmount('100.5') // 100500000n
const formatted = formatAmount(100500000n) // "100.5"
```

### Memo Encoding

Memos are encoded as bytes32:

```bash
# String memo (max 31 chars)
baton token transfer   100 --memo "Payment"

# Or hex bytes32
baton token transfer   100 --memo "0x..."
```

### Tick Pricing

DEX prices use tick values:

```typescript
import { priceToTick, tickToPrice } from '@augmnt-sh/baton'

const tick = priceToTick(1.0001) // Get tick for price
const price = tickToPrice(100)   // Get price from tick
```

## Known Tokens

| Token | Address |
|-------|---------|
| pathUSD | `0x20c0000000000000000000000000000000000000` |
| AlphaUSD | `0x20c0000000000000000000000000000000000001` |
| BetaUSD | `0x20c0000000000000000000000000000000000002` |
| ThetaUSD | `0x20c0000000000000000000000000000000000003` |

## Contract Addresses

| Contract | Address |
|----------|---------|
| TIP20_FACTORY | `0x20fc000000000000000000000000000000000000` |
| STABLECOIN_DEX | `0xdec0000000000000000000000000000000000000` |
| FEE_MANAGER | `0xfeec000000000000000000000000000000000000` |
| ACCOUNT_KEYCHAIN | `0xAAAAAAAA00000000000000000000000000000000` |
| FEE_AMM | `0xfee0000000000000000000000000000000000000` |
| POLICY_REGISTRY | `0x403000000000000000000000000000000000000` |
| MULTICALL3 | `0xcA11bde05977b3631167028862bE2a173976CA11` |

## Security

- **Never share your private key**
- Private keys are read from `TEMPO_PRIVATE_KEY` environment variable
- Keys are never logged or stored
- Use access keys for delegated permissions

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [augmnt](https://github.com/augmnt)
- **Source:** [augmnt/baton](https://github.com/augmnt/baton)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-augmnt-baton
- Seller: https://agentstack.voostack.com/s/augmnt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.