MCP Server
Install
Requirements
Bun 1.1 or later. @altananetwork/mcp ships as TypeScript and runs under Bun, which is why every command below uses bunx. Substituting npx fails with a TypeScript syntax error rather than a useful message.
Claude Code
claude mcp add altana -- bunx @altananetwork/mcpThat's it. Restart Claude Code; tools and slash commands become available.
To remove:
claude mcp remove altanaNetwork
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) |
bnb-testnet | BNB Smart Chain Testnet (97) |
celo-sepolia | Celo Sepolia (11142220) |
celo | Celo (42220) |
Chain ids (56, 1, 97, 11142220, 42220) work too.
# Operate on Ethereum instead of the BNB default
claude mcp add altana -e ALTANA_CHAIN=ethereum -- bunx @altananetwork/mcp
# Operate on BNB testnet (chain 97) โ see the Testnet networks page
claude mcp add altana -e ALTANA_CHAIN=bnb-testnet -- bunx @altananetwork/mcp
# Operate on Celo Sepolia (chain 11142220)
claude mcp add altana -e ALTANA_CHAIN=celo-sepolia -- bunx @altananetwork/mcpOne server process serves one chain. Restart with a different ALTANA_CHAIN to switch.
Agent identity
A wallet that is new on BNB Chain or Celo is registered as an agent
(ERC-8004) after its first action, in a transaction of its own.
The tool's answer carries the agent's number and its page. Set
ALTANA_AGENT_IDENTITY=off to turn it off.
Cursor / Continue / other hosts
Add this to your host's MCP server config:
{
"mcpServers": {
"altana": {
"command": "bunx",
"args": ["@altananetwork/mcp"]
}
}
}Keys
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 bycreate_wallet. ~/.altana/keys.jsonโwallets[]. File fallback. Mode 0600.ALTANA_WALLET_<NAME>_PRIVATE_KEYenv var. Env fallback.
For the default wallet, the convention is ALTANA_WALLET_DEFAULT_PRIVATE_KEY.
- OS keychain under service
altana-session. Primary. Written bygrant_session. ~/.altana/keys.jsonโsessions[]. File fallback.ALTANA_SESSION_<NAME>_PRIVATE_KEYenv var.
Altana never sees these keys. They stay on your machine.