> ## Documentation Index
> Fetch the complete documentation index at: https://docs.portalhq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentic wallets

> Use Portal's local MCP extension or CLI to create and manage a Portal MPC wallet from Claude Desktop, Antigravity, or another local agent.

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.

<Warning>
  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.
</Warning>

## 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:

```text theme={null}
Create a new Portal wallet and share the address with me.
```

## Downloads

Download the current artifacts from the [Portal Agentic MCP v0.1.2 release](https://github.com/portal-hq/portal-agentic-mcp/releases/tag/v0.1.2).

| Client                   | Platform            | Download                                                                                                                                                                              |
| ------------------------ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Claude Desktop extension | macOS Apple Silicon | [`portal-agentic-mcp-0.1.2-darwin-arm64.mcpb`](https://github.com/portal-hq/portal-agentic-mcp/releases/download/v0.1.2/portal-agentic-mcp-0.1.2-darwin-arm64.mcpb)                   |
| Antigravity CLI plugin   | macOS Apple Silicon | [`portal-wallet-antigravity-0.1.2-darwin-arm64.tar.gz`](https://github.com/portal-hq/portal-agentic-mcp/releases/download/v0.1.2/portal-wallet-antigravity-0.1.2-darwin-arm64.tar.gz) |
| Portal Wallet CLI        | macOS Apple Silicon | [`portal-wallet-0.1.2-darwin-arm64.tar.gz`](https://github.com/portal-hq/portal-agentic-mcp/releases/download/v0.1.2/portal-wallet-0.1.2-darwin-arm64.tar.gz)                         |
| Checksums                | All artifacts       | [`SHA256SUMS`](https://github.com/portal-hq/portal-agentic-mcp/releases/download/v0.1.2/SHA256SUMS)                                                                                   |

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:

```bash theme={null}
tar -xzf portal-wallet-antigravity-0.1.2-darwin-arm64.tar.gz -C /tmp
```

Install the extracted plugin:

```bash theme={null}
agy plugin install /tmp/portal-wallet-antigravity-0.1.2-darwin-arm64
```

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:

```bash theme={null}
tar -xzf portal-wallet-0.1.2-darwin-arm64.tar.gz
```

Run the CLI from the extracted directory:

```bash theme={null}
./portal-wallet-0.1.2-darwin-arm64/bin/portal-wallet status
./portal-wallet-0.1.2-darwin-arm64/bin/portal-wallet create --wait
```

You can move the `portal-wallet` binary onto your `PATH` if you want to run it from any directory.

Common commands:

```bash theme={null}
portal-wallet status
portal-wallet create --wait
portal-wallet addresses
portal-wallet assets --chain eip155:11155111
portal-wallet disconnect --yes
```

Use `--json` for automation or agents that can run local shell commands:

```bash theme={null}
portal-wallet --json status
```

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:

```text theme={null}
Use the local portal-wallet CLI to create and manage my Portal Agentic wallet.
Prefer --json output when reading wallet status, addresses, balances, or command results.
Do not ask me to paste Portal API keys, session tokens, or MPC share data.
Before signing, sending assets, or making x402 paid requests, ask me to confirm the exact action.
```

Useful commands for a local agent:

```bash theme={null}
portal-wallet --json status
portal-wallet create --wait
portal-wallet --json addresses
portal-wallet --json assets --chain eip155:11155111
```

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.

| Item                        | Where it lives                              |
| --------------------------- | ------------------------------------------- |
| Portal API credentials      | OS credential storage on the user's device  |
| MPC client share data       | OS credential storage on the user's device  |
| Temporary bootstrap state   | Local app metadata on the user's device     |
| Agentic activation approval | Portal Agentic app after email verification |

## 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:

```json theme={null}
{
  "mcpServers": {
    "portal-wallet": {
      "command": "sh",
      "args": [
        "-c",
        "$HOME/.gemini/config/plugins/portal-wallet/bin/portal-wallet mcp"
      ]
    }
  }
}
```

### 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.

## Related docs

* [API quickstart](/apis/quickstart)
* [Enclave MPC API guide](/apis/enclave-mpc/guide/getting-started)
* [Chain ID formatting](/resources/chain-id-formatting)
* [Testnet faucets](/resources/testnet-faucets)