wallet_unlock

Unlock the agent's wallet to enable transactions. If no wallet ID is provided, unlocks the active wallet.

Handles credentials or secrets (password)

Part of the Aibtc MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.

// WHEN AI AGENTS USE THIS TOOL

AI agents use wallet_unlock to create or modify resources in Aibtc. Write operations carry medium risk because an autonomous agent could trigger bulk unintended modifications. Rate limits prevent a single agent session from making hundreds of changes in rapid succession. Argument validation ensures the agent passes expected values.

// WHY ENFORCE A POLICY ON WALLET_UNLOCK

Without a policy, an AI agent could call wallet_unlock repeatedly, creating or modifying resources faster than any human could review. Intercept's rate limiting ensures write operations happen at a controlled pace, and argument validation catches malformed or unexpected inputs before they reach Aibtc.

// RECOMMENDED POLICY

Write tools can modify data. A rate limit prevents runaway bulk operations from AI agents.

io-github-aibtcdev-mcp-server.yaml

tools:
  wallet_unlock:
    rules:
      - action: allow
        rate_limit:
          max: 30
          window: 60

See the full Aibtc policy for all 288 tools.

// DETAILS

Tool Name wallet_unlock

Category Write

MCP Server Aibtc MCP Server

Risk Level Medium

// MORE AIBTC TOOLS

Financial identity_transfer Financial jingswap_deposit_sbtc Financial jingswap_deposit_stx Financial ordinals_p2p_transfer Financial pillar_direct_withdraw_collateral Financial sbtc_deposit Financial sbtc_transfer Financial sbtc_withdraw

View all 288 tools →

// RELATED READING

// FAQ

What does the wallet_unlock tool do? +

Unlock the agent's wallet to enable transactions. If no wallet ID is provided, unlocks the active wallet.. It is categorised as a Write tool in the Aibtc MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on wallet_unlock? +

Add a rule in your Intercept YAML policy under the tools section for wallet_unlock. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the Aibtc MCP server.

What risk level is wallet_unlock? +

wallet_unlock is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit wallet_unlock? +

Yes. Add a rate_limit block to the wallet_unlock rule in your Intercept policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block wallet_unlock completely? +

Set action: deny in the Intercept policy for wallet_unlock. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides wallet_unlock? +

wallet_unlock is provided by the Aibtc MCP server (@aibtc/mcp-server). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

wallet_unlock

Enforce policies on Aibtc