MCP Server

Install

Claude Code

claude mcp add altana -- bunx @altananetwork/mcp

That's it. Restart Claude Code; tools and slash commands become available.

To remove:

claude mcp remove altana

The server operates on one chain, selected at startup via the ALTANA_CHAIN environment variable. It defaults to BNB Smart Chain.

`ALTANA_CHAIN`	Chain
`bnb` (default)	BNB Smart Chain (56)
`ethereum`	Ethereum (1)

# Operate on Ethereum instead of the BNB default
claude mcp add altana -e ALTANA_CHAIN=ethereum -- bunx @altananetwork/mcp

One server process serves one chain. Restart with a different ALTANA_CHAIN to switch.

Add this to your host's MCP server config:

{
  "mcpServers": {
    "altana": {
      "command": "bunx",
      "args": ["@altananetwork/mcp"]
    }
  }
}

Wallet admin keys and session keys live in separate namespaces so they can never collide. The server reads each kind from three places, in order.

Wallet admin keys:

OS keychain under service altana-wallet. Primary. Written by create_wallet.
~/.altana/keys.json → wallets[]. File fallback. Mode 0600.
ALTANA_WALLET_<NAME>_PRIVATE_KEY env var. Env fallback.

For the default wallet, the convention is ALTANA_WALLET_DEFAULT_PRIVATE_KEY.

Session keys:

OS keychain under service altana-session. Primary. Written by grant_session.
~/.altana/keys.json → sessions[]. File fallback.
ALTANA_SESSION_<NAME>_PRIVATE_KEY env var.

Altana never sees these keys. They stay on your machine.