# IC Phantom — AI agent documentation index

> Machine-readable entry point for AI agents and MCP clients that interact with
> this Internet Computer wallet via Internet Identity.

## App

- **Name:** IC Phantom
- **Human UI:** https://hbxmr-wyaaa-aaaap-an3ia-cai.icp.net/
- **Alt UI host:** https://hbxmr-wyaaa-aaaap-an3ia-cai.icp0.io/
- **Backend canister:** `f4kcz-fqaaa-aaaap-an3hq-cai`
- **Frontend asset canister:** `hbxmr-wyaaa-aaaap-an3ia-cai`
- **Network:** Internet Computer mainnet (`https://icp-api.io`)
- **Auth for agents:** Internet Identity (preferred). Phantom UI is human/browser only.

## Documentation for agents (read these)

| Resource | URL | Purpose |
|----------|-----|---------|
| This index | https://hbxmr-wyaaa-aaaap-an3ia-cai.icp.net/llms.txt | Discovery |
| Well-known index | https://hbxmr-wyaaa-aaaap-an3ia-cai.icp.net/.well-known/llms.txt | Discovery |
| Full agent guide | https://hbxmr-wyaaa-aaaap-an3ia-cai.icp.net/agents.md | How to authenticate and call methods |
| Structured metadata | https://hbxmr-wyaaa-aaaap-an3ia-cai.icp.net/agent.json | Machine JSON (IDs, methods, units) |
| Candid interface | https://hbxmr-wyaaa-aaaap-an3ia-cai.icp.net/backend.did | Backend IDL |

## Quick facts

- Multi-asset wallet: **ICP, SOL, DOGE, BTC/ckBTC**
- Agent path uses methods ending in `_ii` (Internet Identity caller)
- Amounts are **integer smallest units** (e8s / sats / lamports) on the canister API
- Native **BTC has no balance line** until `mint_ckbtc_from_btc_ii` after confirmations
- **Never invent flags** for `icp` CLI — verify with `icp <cmd> --help`
- **Always ask the user before state-changing calls** (transfers, withdraw, mint)

## Internet Identity for agents

Agents should authenticate as the user's **app-specific principal** for this frontend domain.

- Derivation app domain (no scheme): `hbxmr-wyaaa-aaaap-an3ia-cai.icp0.io`
- Also valid UI domain: `hbxmr-wyaaa-aaaap-an3ia-cai.icp.net`
- MCP / II CLI connector reference: https://mcp.beta.id.ai/
- CLI pattern (same machine as browser): `icp identity link web` with `--app hbxmr-wyaaa-aaaap-an3ia-cai.icp0.io`

See **agents.md** for the full auth + call cookbook.

## Human users

The browser UI at the Human UI URL remains the primary experience for people
using Internet Identity passkeys or the Phantom extension. Agent docs do not
replace the UI.