Skip to main content
Portal Agentic Wallets let a user create and manage a Portal MPC wallet from an AI assistant. The V1 experience uses a local MCP extension or CLI, a human activation step in the Agentic app, and Portal’s Enclave MPC API for wallet operations.
Agentic wallets are currently in private beta. You need an invite code to activate a wallet. Use small amounts while testing signing and sending flows.

​
How it works

The Agentic setup flow keeps wallet approval human-controlled while letting the assistant or local CLI handle the mechanical setup work.
  1. Install the Portal extension for Claude Desktop, install the Antigravity plugin, or download the portal-wallet CLI.
  2. Ask your assistant to create a Portal wallet, or run portal-wallet create --wait.
  3. The local tool starts a Portal Agentic bootstrap request.
  4. Portal returns an activation link.
  5. Open the link at https://agentic-app.portalhq.io, enter your invite code and email, then verify the magic link.
  6. The local tool completes wallet creation and returns the wallet address.
Example prompt:

​
Downloads

Download the current artifacts from the Portal Agentic MCP v0.1.2 release. You can verify downloaded files with the SHA256SUMS file in the same release.

​
Install in Claude Desktop

  1. Open Claude Desktop settings.
  2. Go to Extensions.
  3. Open Advanced settings.
  4. Click Install Extension.
  5. Select the downloaded .mcpb file.
Restart Claude Desktop after installing or updating the extension.

​
Install in Antigravity CLI

Download and extract the Antigravity plugin:
Install the extracted plugin:
Restart Antigravity CLI after installing or updating the plugin. Use the MCP server list in Antigravity to confirm that portal-wallet is available.

​
Use the Portal Wallet CLI

Download and extract the CLI:
Run the CLI from the extracted directory:
You can move the portal-wallet binary onto your PATH if you want to run it from any directory. Common commands:
Use --json for automation or agents that can run local shell commands:
The CLI shares the same OS credential storage and local metadata model as the MCP extensions.

​
Use the CLI from ChatGPT or another local agent

ChatGPT web does not directly install local MCP servers or run local binaries. To use Portal Wallet with ChatGPT, run ChatGPT in a local agent environment that can execute shell commands, or ask ChatGPT for commands and run them yourself. When your local agent can run shell commands, point it at the installed portal-wallet binary and ask it to prefer JSON output:
Useful commands for a local agent:
For state-changing actions, the CLI requires confirmation by default. A local agent should only pass --yes after the user explicitly confirms the action.

​
Security model

The Agentic MCP extension and CLI run on the user’s device and communicate with Portal APIs only when a tool needs to create, read, sign, send, or pay.

​
What your assistant can do

After setup, your assistant can use the local extension or CLI to:
  • Create or resume wallet setup.
  • Retrieve wallet addresses and balances.
  • Sign messages or transactions.
  • Send assets when the user explicitly asks for a transfer.
  • Make bounded x402 paid requests when the requested payment is within the user-supplied maximum amount.
  • Disconnect and clear local Portal Agentic state.
The extension exposes these capabilities through MCP tools, but most users should not need to call individual tools manually. Ask your assistant for the wallet action you want, and it can choose the relevant tool.

​
Troubleshooting

​
Claude Desktop does not see the Portal tools

Restart Claude Desktop after installing the .mcpb extension. If the tools still do not appear, remove and reinstall the extension.

​
Antigravity does not see the Portal MCP server

Restart Antigravity CLI after installing the plugin. If the MCP server still does not appear, confirm the Antigravity MCP config points at the staged plugin binary:

​
The portal-wallet command is not found

Run the binary from the extracted directory, or move it onto your PATH.

​
ChatGPT cannot run portal-wallet

ChatGPT web cannot execute local shell commands on its own. Use a local agent environment with shell access, or have ChatGPT provide the command for you to run manually in your terminal.

​
The invite code fails

Invite codes are single-use and expire. Request a new invite code if the code was already used, expired, or copied incorrectly.

​
The assistant stops after activation

Ask the assistant to continue creating the Portal wallet, or run portal-wallet create --wait. The local tool can resume pending bootstrap state and finish wallet creation after email verification.

​
A wallet already exists locally

Use the disconnect action only if you intentionally want to remove local Portal Agentic credentials and wallet share data from this device. Disconnecting local state does not delete onchain funds.