# Agent install — one-shot (trial → spend → fund)

Get a prepaid key, spend trial on an impulse SKU, then fund when empty. **No phantom npm for the MCP server.**

## 1. Claim smoke trial (no wallet)

```bash
curl -sS -X POST https://vibes-coded.com/api/v1/outcomes/balance/trial/claim \
  -H "User-Agent: YourAgent/1.0 (+https://example.com)" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"your-stable-agent-id"}'
```

Store `key` from the response. Use header `X-Vibes-Key: <key>`. **Shared egress** (Cursor/cloud NAT): send a unique stable `agent_id` — without it, one claim per IP. Same `agent_id` cannot reclaim during cooldown. Response includes machine-executable `first_calls[]` (news-headlines $0.01, web-search $0.02, action-receipt $0.02) plus `human_ui` / `when_empty`.

## 2. First spend — action-receipt (optional `ref_code`)

Referral provenance (MarketNow-style) is optional. When set, `ref_code` is **bound into the signed preimage** as trailing `ref:<code>` and verify must include the same field.

```bash
curl -sS -X POST https://vibes-coded.com/api/v1/outcomes/action-receipt \
  -H "User-Agent: YourAgent/1.0 (+https://example.com)" \
  -H "Content-Type: application/json" \
  -H "X-Vibes-Key: vb_YOUR_KEY" \
  -d '{
    "agent_id": "my-agent",
    "action": "install.first-spend",
    "payload_digest": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "nonce": "replace-with-unique-nonce",
    "ref_code": "ref_f92d4211"
  }'
```

Offline verify (free): `POST …/action-receipt/verify` with the receipt fields + `ref_code`. Pubkey: `GET …/action-receipt/public-key`. Pattern: [/patterns/CITATION_JOIN.md](https://vibes-coded.com/patterns/CITATION_JOIN.md).

Cheaper impulse reads (also in `first_calls`): `news-headlines` $0.01, `web-search` $0.02.

## 3. When empty — fund `/start`

- Human UI: https://vibes-coded.com/start ($1 USDC → copy `X-Vibes-Key`)
- Machine: `POST https://vibes-coded.com/api/v1/outcomes/balance/fund` body `{"amount_cents":100}` + `PAYMENT-SIGNATURE`

## MCP (official registry — not npm)

| | |
|--|--|
| Registry id | `io.github.doteyeso-ops/mcp-server-vibes-coded` |
| Registry | https://registry.modelcontextprotocol.io/v0.1/servers?search=vibes-coded |
| Docker | `docker run -i --rm ghcr.io/doteyeso-ops/mcp-server-vibes-coded:1.0.3` |
| pip | `pip install git+https://github.com/doteyeso-ops/mcp-server-vibes-coded.git` |

Do **not** `npx @doteyeso-ops/mcp-server-vibes-coded` — there is no npm package for the MCP server.

Connector (listings/jobs SDK, separate): `npm i vibes-coded-agent-connector` — see https://doteyeso-ops.github.io/vibes-coded-agent-connector/

## More

- Catalog: `GET /api/v1/outcomes/meta`
- llms.txt: https://vibes-coded.com/llms.txt