> ## Documentation Index
> Fetch the complete documentation index at: https://crushrewards.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MPP / Tempo

> Hosted micropayments via Tempo for agents that can't sign on-chain transactions.

The Micropayment Protocol (MPP) is a hosted alternative to x402. Tempo manages the wallet, settlement, and key custody so your agent never touches crypto directly.

## When to use MPP instead of x402

Pick MPP if any of these apply:

* Your agent runs in an environment where you can't safely manage signing keys (e.g. browser extensions, server-side LLM calls without a wallet provider).
* You want a single funded balance shared across many agents in your org, with usage analytics in one dashboard.
* You're already using Tempo for other agentic API integrations.

## How it works

```mermaid theme={null}
sequenceDiagram
    participant Agent
    participant Tempo
    participant API as Syntalic API

    Agent->>Tempo: Open MPP session
    Tempo-->>Agent: Session token
    Agent->>API: GET /v1/shopper/best-price?q=...<br/>X-MPP-Session: <token>
    API->>Tempo: Verify session, debit
    Tempo-->>API: OK, payment recorded
    API-->>Agent: 200 OK<br/>{ best, alternatives, ... }
```

The session token is bound to your Tempo account. Each request debits the per-call price from your balance.

## Using `mppx`

Install the Tempo client:

```bash theme={null}
npm install mppx
```

```ts theme={null}
import { MppClient } from "mppx";

const mpp = new MppClient({ apiKey: process.env.TEMPO_API_KEY });

const session = await mpp.openSession({
  recipient: "<recipient-from-discovery>",
  maxSpend: "1.00",
});

const res = await fetch(
  "https://api.syntalic.com/v1/shopper/best-price?q=airpods+pro&country=us",
  { headers: { "X-MPP-Session": session.token } }
);
```

## Pricing

MPP pricing matches x402 exactly — \$0.01 for shopper/marketing endpoints, \$0.02 for analyst endpoints. Tempo does not charge a markup on per-request fees, but they do require a minimum prepaid balance to open a session.

## Funding

Top up your Tempo balance via the [Tempo dashboard](https://tempo.network) using a credit card, ACH, or USDC deposit. Balance applies across all MPP-enabled APIs, not just Syntalic.
