# IMBA Agent MCP

Personal GitHub copy for catalogs that require **the connected GitHub username to own the repository** (LobeHub Marketplace). Same npm packages and hosted remotes as the org repo.

Canonical Docker / Glama / Official Registry source: [IMBAwallet/agent-mcp](https://github.com/IMBAwallet/agent-mcp)

This repository does not contain API keys, Ed25519 private keys, or registry seeds.

| File | npm | Registry name | What it does |
|---|---|---|---|
| `Dockerfile` / `Dockerfile.docs` | `@imba_wallet/agent-mcp-docs` | `com.imbawallet/agent-docs` | Policy, HowTo, what agents buy. Docs only. |
| `Dockerfile.spend` | `@imba_wallet/agent-mcp` | `com.imbawallet/agent` | USDT TRC-20 + Visa prepaid / eSIM / gift cards with **your** key. |

Hosted remotes: [docs](https://imbawallet.com/mcp/docs) · [spend](https://imbawallet.com/mcp/spend)

Playbooks: [what agents buy](https://imbawallet.com/agent_use_cases_about_en.html) · [HowTo](https://imbawallet.com/agent_api_about_en.html) · [API docs](https://api-docs.imbawallet.com/agent)

LobeHub: `lhm.plugin.json` (docs MCP, `cloudEndpoint` `https://imbawallet.com/mcp/docs`). Publish:

```bash
npx -y @lobehub/market-cli plugin publish https://github.com/clnt2021/imba_agent_mcp --dir .
```

## What agents buy

IMBA issues the **payment instrument**:

- **Visa/MasterCard prepaid** — airlines, hotels, SaaS, or a datacenter that bills a card
- **Travel eSIM** — cheap mobile data
- **Gift cards** — live catalog (~20,000 positions; Apple, Steam, Google Play — search, do not hard-code a SKU)

ChatGPT Actions must not call spend.

## Install (stdio)

Docs:

```bash
npx -y @imba_wallet/agent-mcp-docs@0.1.5
```

```json
{
  "mcpServers": {
    "imba-agent-docs": {
      "command": "npx",
      "args": ["-y", "@imba_wallet/agent-mcp-docs@0.1.5"]
    }
  }
}
```

Spend (operator key):

```json
{
  "mcpServers": {
    "imba-agent": {
      "command": "npx",
      "args": ["-y", "@imba_wallet/agent-mcp"],
      "env": {
        "IMBA_AGENT_CLIENT_ID": "YOUR_CLIENT_ID",
        "IMBA_AGENT_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----"
      }
    }
  }
}
```

Claude Code:

```text
/plugin marketplace add clnt2021/imba_agent_mcp
/plugin install imba-agent@imba-agent
```

Agent skill: `npx skills add clnt2021/imba_agent_mcp --skill imba-agent`

## Keep in sync

When catalog packaging changes (`plugin.json`, `mcp.json`, `skills/`, `llms-install.md`, Dockerfiles, `lhm.plugin.json`), update **this repo and** `IMBAwallet/agent-mcp`. SSOT in Wallet: `docs/features/agent_mcp.md`.