`bash


Use testnet

`bash
baton mcp
`

$3

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
`

$3

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"
}
}
}
}
`

$3

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 |

$3

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

$3

- 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

$3

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

`bash


Transfer 100.5 tokens

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

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

$3

Memos are encoded as bytes32:

`bash


String memo (max 31 chars)

`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