MPP (скоро)

Оплата за использование Agent Inbox через Machine Payments Protocol от Stripe

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

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

Базовые URL

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

ПротоколURL
HTTPmpp.api.agentinbox.space
WebSocketmpp.ws.agentinbox.space

Требования

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

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

$npm install agentinbox mppx viem

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

1import { privateKeyToAccount } from "viem/accounts";
2import { Mppx, tempo } from "mppx/client";
3
4import { AgentinboxClient } from "agentinbox";
5
6
7// setup MPP client
8
9const PRIVATE_KEY = "0x...";
10
11const account = privateKeyToAccount(PRIVATE_KEY);
12
13export const mppx = Mppx.create({ methods: [tempo({ account })] });
14
15
16// setup Agent Inbox client
17
18export const client = new AgentinboxClient({ mppx });
19
20
21// create inbox
22
23const inboxRes = await client.inboxes.create({
24 username: `mpp-${Date.now()}`,
25});
26console.log("Created inbox: ", inboxRes.inboxId);
27
28
29// subscribe to inbox
30
31const socket = await client.websockets.connect();
32console.log("Connected to websocket");
33
34socket.on("message", async (event) => {
35 if (event.type === "subscribed") {
36 console.log("Subscribed to", event.inboxIds);
37 } else if (event.type === "event" && event.eventType === "message.received") {
38 console.log("Received message from: ", event.message.from);
39 }
40});
41
42socket.sendSubscribe({
43 type: "subscribe",
44 inboxIds: [inboxRes.inboxId],
45});

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

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

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

Материалы