MCP Server
Tools
The Altana MCP server exposes 20 tools. AI hosts call them by name. Eleven of them also have a slash command for users to invoke directly (e.g. /altana-agentic-wallet:create-wallet); the rest are host-callable only. See Slash command equivalents.
Discovery
| Tool | Purpose |
|---|---|
about_altana | Returns Altana's positioning, Keystore explainer, and SDK surface. AI hosts call this when the user asks "what is Altana". |
Wallet lifecycle
| Tool | Purpose |
|---|---|
create_wallet | Generates a new private key, stores it in the OS keychain under the given name, returns the address. |
list_wallets | Lists wallet names available on this machine (across keychain, file, env). |
wallet_balance | Reads native + optional ERC-20 balances for a stored wallet (pass tokens). BEP-677 scaled-UI-amount tokens are detected via ERC-165 and their display value is scaled automatically; raw stays the on-chain amount. |
wallet_execute | Submits one or more calls signed by the wallet's admin key. |
Verification
| Tool | Purpose |
|---|---|
wallet_verification | Lists all active keys on a wallet from Keystore. |
verify_authorization | Answers: is this key/session authorized on this wallet right now? |
Session lifecycle
| Tool | Purpose |
|---|---|
grant_session | Generates a session key, registers it in Keystore, authorizes it with the given permissions. Returns the session details, keyId, and the grant's transaction hash. |
list_sessions | Lists local session metadata (those granted from this machine). |
session_execute | Submits calls signed by a stored session key. |
revoke_session | Deactivates the session in Keystore and pulls onchain authority. |
Agent commerce
| Tool | Purpose |
|---|---|
x402_request | Fetches an HTTP URL, transparently paying an x402/B402 payment challenge with a session key (Permit2 or EIP-3009), and returns the paid resource. |
erc8183_create_job | Hires an ERC-8183 seller agent (e.g. any BNB Agent Studio agent): escrows $U against its address for a task — the whole buyer flow as one atomic relay intent. |
erc8183_job_status | Reads a job's on-chain state; once the seller submits, resolves and fetches the deliverable. |
erc8183_settle | Releases the escrow to the seller after the dispute window (approve), or contests inside it (dispute). |
Agent identity
On-chain ERC-8004 identity, so an agent on an Altana wallet is discoverable by buyers and other agents. The session must have been granted erc8004RegisterPermissions(chainId); the write tools check that client-side before spending gas.
| Tool | Purpose |
|---|---|
erc8004_register | Mints the agent's identity and publishes its registration record, running both phases (mint, then write the assigned agentId back into the record). If the mint lands but the write-back fails, the agentId is still returned with repair instructions — registering again would mint a second identity. |
erc8004_set_agent_uri | Rewrites the record of an agent the wallet owns — changing its endpoint, or repairing a partial registration. Takes a ready-made agentUri or the structured fields. |
erc8004_show | Reads an agent's owner and registration record by id, decoding the record when it is a base64 data URI. |
Skills
Certified protocol playbooks from the Altana skills registry. The registry URL defaults to the public repo's main branch and is overridable with the ALTANA_SKILLS_INDEX_URL environment variable.
| Tool | Purpose |
|---|---|
search_skills | Keyword search over the registry (name, description, tags). Returns matching skills with their scope and certification scorecard, ranked by how many query words match. Call when the user asks to trade or interact with a DeFi protocol. |
get_skill | Fetches one skill's full SKILL.md playbook by id. The content is integrity checked against the registry's sha256 before it is returned, so a tampered playbook is rejected rather than followed. Also returns the skill's scope (allowed contracts, suggested spend cap) and scorecard. |
Slash command equivalents
Eleven of the 20 tools have a matching prompt, exposed as a slash command. One further command, demos, lists demo flows and maps to no tool:
| Slash command | Calls |
|---|---|
/altana-agentic-wallet:about | about_altana |
/altana-agentic-wallet:create-wallet | create_wallet |
/altana-agentic-wallet:list-wallets | list_wallets |
/altana-agentic-wallet:wallet-balance | wallet_balance |
/altana-agentic-wallet:wallet-info | wallet_verification |
/altana-agentic-wallet:verify-session | verify_authorization |
/altana-agentic-wallet:grant-session | grant_session |
/altana-agentic-wallet:list-sessions | list_sessions |
/altana-agentic-wallet:session-execute | session_execute |
/altana-agentic-wallet:revoke-session | revoke_session |
/altana-agentic-wallet:send-tx | wallet_execute |
/altana-agentic-wallet:demos | listing of available demo flows |
Nine tools have no slash command: x402_request, erc8183_create_job, erc8183_job_status, erc8183_settle, erc8004_register, erc8004_set_agent_uri, erc8004_show, search_skills, and get_skill. Ask the host to use them by name instead; typing /altana-agentic-wallet:x402-request will not resolve.