Skip to main content

Admin tools

The admin tools let an AI assistant, or a person in a terminal, manage an organization with the rights of the person who signed in: create applications, create and configure agent wallets, set their spending policy and destination rules, read balances and payments. They are distinct from the wallet tools, which an agent uses to pay (see Wallet MCP tools). This page lists the whole admin surface.

There are two ways to reach them, described on CLI, MCP and API:

  • The Keyban MCP server. Once a person has run keyban admin login on the machine, npx -y @keyban/cli@latest mcp serves the admin tools beside the wallet tools, on stdio, which is its default.
  • The keyban admin commands. After keyban admin login, each tool below is a command named in kebab-case: list_wallets is keyban admin list-wallets. npx -y @keyban/cli@latest admin --help lists them.

Sign in only on your own machine, never on one where an agent runs on its own: the agent would get your rights.

The REST API does the same from your backend, with an organization API key: every tool below is built from one of its operations.

How to read this page​

  • Name is what the assistant calls.
  • Type is Tool for an action that changes something, and Resource for read-only data. The Keyban MCP server serves both as tools.
  • What it does is the summary of the underlying API operation. For the request and response fields, follow the operation in the Backend OpenAPI reference.
  • Every operation runs with the permissions of the person who signed in. An assistant can do only what that person is allowed to do in the Keyban dashboard.

Three groups of operations are not in the tables:

  • The operations served to the wallet MCP instead, such as the mission tools, are on the Wallet MCP tools page.
  • The operations that return signer credentials are never exposed as MCP tools, because an assistant's answer would carry those credentials to the language model.
  • Operations without an MCP name exist in the API but cannot be called through MCP. A few exist as keyban admin commands only.

Tools and resources​

Agent Wallets​

NameTypeWhat it does
create_walletToolCreate an agent wallet
create_wallet_follower_keyToolMint a read-only follower API key for an agent wallet
delete_walletToolDelete an agent wallet
get_walletResourceGet an agent wallet
get_wallet_balanceResourceRead the balance of an agent wallet
get_wallet_welcome_offerResourceRead the Keyban welcome offer
list_wallet_paymentsResourceList agent wallet intents
list_walletsResourceList agent wallets
update_walletToolUpdate an agent wallet

Applications​

NameTypeWhat it does
create_applicationToolCreate an application
delete_applicationToolDelete an application
get_applicationResourceGet an application
list_applicationsResourceList applications
update_applicationToolUpdate an application

Destination Rules​

NameTypeWhat it does
delete_application_destination_ruleToolRemove the application's destination rule
delete_organization_destination_ruleToolRemove the organisation's destination rule
delete_wallet_destination_ruleToolRemove the wallet's destination rule
get_application_destination_ruleResourceGet the application's destination rule
get_organization_destination_ruleResourceGet the organisation's destination rule
get_wallet_destination_ruleResourceGet the wallet's destination rule
set_application_destination_ruleToolCreate or update the application's destination rule
set_organization_destination_ruleToolCreate or update the organisation's destination rule
set_wallet_destination_ruleToolCreate or update the wallet's destination rule

Events​

NameTypeWhat it does
list_eventsResourceList events for the active organization

Exchange Rate​

NameTypeWhat it does
convert_amount_to_fiatResourceConvert an on-chain amount to a fiat currency

Organizations​

NameTypeWhat it does
get_organizationResourceGet an organization by id
update_organizationToolUpdate an organization

Quotas​

NameTypeWhat it does
get_quota_usageResourceGet quota usage history for the active organization
get_transaction_quotaResourceGet the monthly agent wallet transaction quota of the organization
update_transaction_quotaToolUpdate the transaction quota settings of the organization

Shared Budgets​

NameTypeWhat it does
delete_application_shared_budgetToolRemove the application's shared budget
delete_organization_shared_budgetToolRemove the organization's shared budget (owner only)
get_application_shared_budgetResourceGet the application's shared budget and its consumption
get_organization_shared_budgetResourceGet the organization's shared budget and its consumption
set_application_shared_budgetToolCreate or replace the application's shared budget
set_organization_shared_budgetToolCreate or replace the organization's shared budget (owner only)

Wallet Policy​

NameTypeWhat it does
freeze_walletToolEngage emergency stop (deny all requests for this wallet)
get_wallet_paymentResourceGet one policy intent with its timeline and current (re-priced) value
get_wallet_policyResourceGet the policy attached to an agent wallet
list_wallet_payment_historyResourceList an agent wallet's policy intents (newest first)
reset_wallet_policyToolReset an agent wallet's policy to an unrestricted one
set_wallet_policyToolCreate or update the policy attached to an agent wallet
unfreeze_walletToolRelease emergency stop (re-enable the wallet)

Webhook​

NameTypeWhat it does
create_webhook_endpointToolCreate a webhook endpoint
delete_webhook_endpointToolDelete a webhook endpoint
list_webhook_endpointsResourceList webhook endpoints
rotate_webhook_secretToolRotate a webhook signing secret
update_webhook_endpointToolUpdate a webhook endpoint

x402 Discovery​

NameTypeWhat it does
get_x402_serviceResourceGet one x402 service
list_x402_servicesResourceList x402 services