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.
The Keystore is on the chain the server runs on, and every tool works on that one chain: wallet_verification and verify_authorization read its Keystore, and grant_session and revoke_session return a status and legs, with the Keystore write in the same transaction as the account's. See Keystore.
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 for specific ERC-20s, or discover: true to list every token the wallet holds (discovered through the Altana relay, zero balances omitted, result flagged discovered: true). 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. The relay takes its fee in whichever accepted token the wallet holds; feeToken forces one address, or with a list pays with the first the relay accepts and the wallet holds. The result names the token charged (feeToken). |
list_fee_currencies | Lists the tokens the relay accepts as fee payment on the selected chain, with the rate each is priced at, read live. Pass a wallet name to see its balance of each. |
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. feeToken (one address or a list) names the tokens the session may pay relay fees in; each gets a daily spend cap added (feeSpendLimit, in the token's smallest unit, overrides the one-whole-token default). x402Tokens (one token address or a list) sets the session up to pay x402 requests in those tokens. 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. The fee comes out of the session's spend caps: the capped token the relay accepts that the wallet holds the most of; feeToken forces one address, or with a list pays with the first that qualifies. The result names the token charged (feeToken). |
revoke_session | Deactivates the session in Keystore and pulls onchain authority, then deletes the local session. A revoke that fails keeps the local session so it can be run again; the result lists each chain's outcome. |
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. The session is one granted with x402Tokens naming the payment token. |
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). |
erc8183_submit | The seller side: submits a job's deliverable — builds the v1 manifest, hashes its canonical form on-chain, and returns the exact bytes to serve at the deliverable URL. |
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.
The registry these write to is erc8004Registry(chainId), listed per network in ERC8004_ADDRESSES.
| 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). A wallet that already has its agent identity has that agent's record updated, and no second agent is created. 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 |
Ten tools have no slash command: x402_request, erc8183_create_job, erc8183_job_status, erc8183_settle, erc8183_submit, 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.