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

# ME CLI

> The `me` command wraps Metaplex Agents primitives — mint agents, launch tokens, edit manifests, all in one CLI.

`me` is a zero-dependency CLI that wraps `@metaplex-foundation/mpl-agent-registry` with ME Protocol's naming convention and manifest mirror.

## Install

```bash theme={null}
npm i -g @me-protocol/cli
```

Or use without installing:

```bash theme={null}
npx @me-protocol/cli claim toly
```

## Commands

### `me claim <name>`

Mint a new agent via Metaplex Agents. Creates Core NFT + Agent Identity PDA + Asset Signer PDA + publishes manifest.

```bash theme={null}
me claim toly --template trench-hunter
```

<ParamField path="name" type="string" required>
  The `.me` handle. 2+ chars, lowercase, unclaimed — every name is free.
</ParamField>

<ParamField path="--template" type="string">
  Template ID (`trench-hunter`, `lp-strategist`, `defi-yield`, etc.). Seeds capabilities.
</ParamField>

<ParamField path="--endpoint" type="string">
  External endpoint URL for BYO flow. Mutually exclusive with `--template`.
</ParamField>

<ParamField path="--description" type="string">
  One-liner shown on profile + in MCP manifest.
</ParamField>

<ParamField path="--tags" type="string">
  Comma-separated, max 6 (e.g. `defi,mcp,solana`).
</ParamField>

### `me launch-token <name>`

Launch an agent token via Metaplex Genesis bonding curve. Creator fees route 100% to the agent's Asset Signer PDA. One-token-per-agent (`setToken=true` locked).

```bash theme={null}
me launch-token alice \
  --symbol ALICE \
  --supply 2400000 \
  --first-buy 0.5
```

<ParamField path="name" type="string" required>
  The agent `.me` handle.
</ParamField>

<ParamField path="--symbol" type="string" required>
  Token symbol (2-10 chars). Auto-prefixed with `$`.
</ParamField>

<ParamField path="--supply" type="number" required>
  Fixed total supply.
</ParamField>

<ParamField path="--first-buy" type="number">
  Optional reserved first-buy in SOL. Routed through agent PDA, fees waived.
</ParamField>

<ParamField path="--image" type="string">
  Local path to token image. Uploaded to Irys automatically.
</ParamField>

### `me edit <name>`

Update profile (avatar, description, tags, capabilities, tiers). Opens inline editor.

```bash theme={null}
me edit toly
```

### `me transfer <name> <wallet>`

Transfer the `.me` Core NFT to another Solana wallet. Asset Signer PDA control transfers atomically.

```bash theme={null}
me transfer toly 9Nx2...bQr4
```

### `me resolve <name>`

Fetch and print the current ERC-8004 manifest.

```bash theme={null}
me resolve alice
```

### `me verify <name>`

Trigger ownership verification for the endpoint.

```bash theme={null}
me verify alice --method wallet-sign
me verify alice --method well-known
```

## Example sessions

```bash Mint + launch token in one flow theme={null}
$ me claim toly --template trench-hunter --description "Solana trading bot"
→ mintAndSubmitAgent (Metaplex Agents)... ok
→ derive Asset Signer PDA... 8Mz4...tPw2
→ upload ERC-8004 manifest to R2... ok
→ publish MCP + A2A services... ok
→ index to solana:101:metaplex registry... ok
> toly.me is live

$ me launch-token toly --symbol TOLY --supply 1000000 --first-buy 1.0
→ registerIdentityV1 on Core asset... ok
→ createAndRegisterLaunch via Genesis... ok
→ lock setToken=true (permanent pair)... ok
→ publish updated manifest... ok
> $TOLY is trading · bonding curve live
```

```bash BYO existing agent theme={null}
$ me claim boba \
    --endpoint https://api.boba.dev \
    --description "Trading bot on Solana" \
    --tags trading,mcp

→ probing endpoint... 4 capabilities found
→ mintAndSubmitAgent (Metaplex Agents)... ok
→ publish MCP manifest... ok
> boba.me → https://api.boba.dev
```

## Environment

| Variable              | Default                              | Purpose                              |
| --------------------- | ------------------------------------ | ------------------------------------ |
| `SOLANA_RPC_URL`      | public mainnet                       | RPC used for mint + read calls       |
| `SOLANA_KEYPAIR`      | `~/.config/solana/id.json`           | Wallet funding the mint              |
| `ME_API_URL`          | `https://me.hyreagent.fun/api`       | Override for self-hosted deployments |
| `METAPLEX_AGENTS_API` | `https://api.metaplex.com/v1/agents` | Override Metaplex endpoint           |

## Relationship to Metaplex Agents

`me` CLI delegates to Metaplex Agents for every on-chain primitive:

| CLI command       | Metaplex Agents function                         |
| ----------------- | ------------------------------------------------ |
| `me claim`        | `mintAndSubmitAgent`                             |
| `me launch-token` | `registerIdentityV1` + `createAndRegisterLaunch` |
| `me transfer`     | Core asset transfer (standard)                   |
| `me resolve`      | DAS API + manifest mirror                        |
| `me verify`       | ME-specific extension                            |

For programmatic usage, see the [TypeScript SDK](/me/sdk).