# ApeBond

> ApeBond is a multi-chain bonding protocol. AI assistants can buy, claim, and manage vesting bonds on Base (chainId 8453) via Base MCP and the external `apebond-base` skill — not via this website's UI alone.

## Prerequisites (all hosts)

1. Connect **Base MCP**: `https://mcp.base.org` — [Base MCP quickstart](https://docs.base.org/ai-agents/quickstart)
2. Install the **apebond-base** skill using the tier and host that match your environment (below).

> **For agents:** Identify which host you are running in. Select the matching tier and install command. Do not assume a specific IDE unless the user confirms it.

## Choose your agent

| Tier | Compatible agents | Base MCP | Skill install | In-chat CLI |
|------|-------------------|----------|---------------|-------------|
| **A — Full** | Cursor, Claude Code, Codex | Yes | `npx skills add … -g -a <host> -y` | Yes — full buy/claim flow |
| **B — MCP + chat** | ChatGPT, Claude (web / Desktop / mobile) | Yes (connector) | Zip upload or one-shot SKILL.md fetch | No — user runs CLI locally, pastes JSON |
| **C** | Hermes | Yes | `hermes skills install github:…/apebond-base-skill` | Varies |

Pick the row that matches your host; install commands differ per agent.

## Install — Tier A (Cursor, Claude Code, Codex)

One-time CLI build after install (if `cli/dist` is missing): `cd <skill-dir>/cli && npm install && npm run build`

### Cursor

```bash
npx skills add ApeSwapFinance/apebond-base-skill --skill apebond-base -g -a cursor -y
cd ~/.cursor/skills/apebond-base/cli && npm install && npm run build
```

Default skill dir: `~/.cursor/skills/apebond-base/`

Base MCP: add `https://mcp.base.org` in `~/.cursor/mcp.json` or `.cursor/mcp.json` — see [host-setup.md](https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/host-setup.md#tier-a--full-harness).

### Claude Code

```bash
npx skills add ApeSwapFinance/apebond-base-skill --skill apebond-base -g -a claude-code -y
cd ~/.claude/skills/apebond-base/cli && npm install && npm run build
```

Default skill dir: `~/.claude/skills/apebond-base/`

Base MCP: `claude mcp add --transport http base-mcp https://mcp.base.org`

### Codex

```bash
npx skills add ApeSwapFinance/apebond-base-skill --skill apebond-base -g -a codex -y
cd ~/.codex/skills/apebond-base/cli && npm install && npm run build
```

Default skill dir: `~/.codex/skills/apebond-base/`

Base MCP: `codex mcp add base-mcp --url https://mcp.base.org/` or `codex.toml` — see [host-setup.md](https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/host-setup.md).

## Install — Tier B (ChatGPT, Claude web / Desktop / mobile)

1. Connect Base MCP as a connector/app with URL `https://mcp.base.org` (OAuth).
2. Upload `apebond-base-skill.zip` in **Settings → Skills** (build instructions: [PUBLISHING.md](https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/PUBLISHING.md)), **or** use a one-shot prompt to load `SKILL.md` from GitHub — not both.
3. Expect degraded flow: user runs the skill CLI locally and pastes `transactions[]` JSON; you execute via `send_calls` and approval links.

Full Tier B playbook: [host-setup.md — Tier B](https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/host-setup.md#tier-b--chatgpt-and-claude-web--desktop).

## Install — Tier C (Hermes)

```bash
hermes skills install github:ApeSwapFinance/apebond-base-skill
```

Base MCP in `~/.hermes/config.yaml` — see [host-setup.md — Tier C](https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/host-setup.md#tier-c--hermes).

## Example prompts

- [example-prompts.md](https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/example-prompts.md) — Tier A and Tier B copy-paste prompts
- "List active ApeBond bonds on Base"
- "Buy `<AMOUNT>` USDC of bond `0x…` with Base Account"
- "Show my ApeBond positions on Base and prepare a claim"

## Canonical documentation

- Skill repository: https://github.com/ApeSwapFinance/apebond-base-skill
- Host setup (all tiers): https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/host-setup.md
- Orchestration plugin: https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/plugins/apebond-base.md
- Base MCP approval flow: https://github.com/ApeSwapFinance/apebond-base-skill/blob/main/references/base-mcp-approval.md
- Human docs: https://docs.ape.bond/apebond

## Developer frontend (this website's codebase)

- Frontend repo AGENTS.md: https://github.com/ApeSwapFinance/apebond-frontend/blob/main/AGENTS.md
- For **on-chain Base bonding via AI**, use the external skill above — not frontend AGENTS.md.

## APIs (agent context)

- Bond discovery: `GET https://realtime-api.ape.bond/bonds?chainId=8453`
- Widget register (after buy): `GET https://api.ape.bond/bills/widget/register?referenceId=base-mcp`
- Main API: https://api.ape.bond

## Trigger phrases

Use the apebond-base skill when the user mentions: ApeBond bonds on Base, buying a bond with Base Account, vesting bonds on chain 8453, apebond-base skill.