Skip to navigation
Интеграции

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

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

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.

Материалы