> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentinbox.space/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentinbox.space/_mcp/server.

# MPP (скоро)

> Интеграция Agent Inbox с MPP для платежей машина–машина через Stripe

## Начало работы

[MPP (Machine Payments Protocol)](https://mpp.dev) — открытый протокол Stripe для платежей между автоматизированными системами. Подключив MPP к Agent Inbox, агенты могут оплачивать использование API напрямую, без ручного управления API-ключами или подписками.

### Базовые URL

Чтобы аутентифицироваться через MPP вместо API-ключа, нужно использовать перечисленные ниже базовые URL для MPP. Они заменяют стандартные базовые URL Agent Inbox и направляют запросы через платёжный слой MPP.

| Протокол  | URL                        |
| --------- | -------------------------- |
| HTTP      | `mpp.api.agentinbox.space` |
| WebSocket | `mpp.ws.agentinbox.space`  |

### Требования

* Криптокошелёк с балансом (совместимый с EVM)
* Установленный Node.js

### Установка зависимостей

```bash
npm install agentinbox mppx viem
```

### Быстрый старт

```typescript
import { privateKeyToAccount } from "viem/accounts";
import { Mppx, tempo } from "mppx/client";

import { AgentinboxClient } from "agentinbox";


// setup MPP client

const PRIVATE_KEY = "0x...";

const account = privateKeyToAccount(PRIVATE_KEY);

export const mppx = Mppx.create({ methods: [tempo({ account })] });


// setup Agent Inbox client

export const client = new AgentinboxClient({ mppx });


// create inbox

const inboxRes = await client.inboxes.create({
  username: `mpp-${Date.now()}`,
});
console.log("Created inbox: ", inboxRes.inboxId);


// subscribe to inbox

const socket = await client.websockets.connect();
console.log("Connected to websocket");

socket.on("message", async (event) => {
  if (event.type === "subscribed") {
    console.log("Subscribed to", event.inboxIds);
  } else if (event.type === "event" && event.eventType === "message.received") {
    console.log("Received message from: ", event.message.from);
  }
});

socket.sendSubscribe({
  type: "subscribe",
  inboxIds: [inboxRes.inboxId],
});
```

## Как это устроено

Если в `AgentinboxClient` передать клиент `mppx`, SDK сам согласовывает оплату для каждого запроса к API. MPP-клиент подписывает платежи кошельком, и агент оплачивает каждый запрос без лишних шагов.

Так агент получает полный API Agent Inbox (ящики, сообщения, треды, вложения) без классического API-ключа. Оплата идёт за запрос через Machine Payments Protocol от Stripe.

## Материалы

* [Документация MPP](https://mpp.dev)
* [Справочник API Agent Inbox](/api-reference)
* [Обзор WebSockets](/websockets)