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

# MPP Tempo Endpoint Families

> Tempo Machine Payments Protocol endpoints under /mpp/*

## Base pattern

```text theme={null}
/mpp/{service}
```

Canonical discovery spec:

`https://wurkapi.fun/openapi.json`

<Note>
  The OpenAPI spec focuses on canonical POST operations. Runtime aliases may also exist in `skill.md`.
</Note>

<Warning>
  Runtime availability for `/mpp/*` depends on MPP Tempo configuration (for example `MPP_ENABLED=1` in server deployments).
</Warning>

## Agent-to-human families

| Family           | Pattern                                       |
| ---------------- | --------------------------------------------- |
| Basic            | `/mpp/agenttohuman`                           |
| Advanced         | `/mpp/agenttohumanadvanced`                   |
| Agent help alias | `/mpp/agenthelp` and `/mpp/agenthelpadvanced` |
| Recovery         | `/mpp/agenttohuman/recover`                   |

## Social service families

Examples:

* `/mpp/xlikes`, `/mpp/xfollowers`, `/mpp/xraid/*`
* `/mpp/instalikes`, `/mpp/instacomments`, `/mpp/instafollowers`
* `/mpp/heylol*`, `/mpp/yt*`, `/mpp/tgmembers`, `/mpp/dcmembers`
* `/mpp/cmcvote`, `/mpp/cgvote`, `/mpp/majorvote`, `/mpp/pfcomments`

## Payment pattern

1. Call `/mpp/...` without `Authorization`.
2. Receive `402` + `WWW-Authenticate: Payment ...`.
3. Parse `application/problem+json` challenge details.
4. Build payment credential from the live challenge.
5. Retry with `Authorization: Payment <credential>`.
6. Read `Payment-Receipt` on success.

## Known naming differences vs x402

* x402 `reposts` is commonly `xreposts` on MPP.
* x402 `comments` is commonly `xcomments` on MPP.
* x402 `bookmarks` is commonly `xbookmarks` on MPP.
* x402 `dex` is commonly `dex-rocket` on MPP.

## Submissions note

For basic MPP agent-to-human jobs, read results via returned `statusUrl` (often `/submissions/agenttohuman?action=view&secret=...`) instead of assuming `action=view` on `/mpp/agenttohuman`.

For advanced jobs, `statusUrl` can point to `/mpp/agenttohumanadvanced?action=view&secret=...`.

<RequestExample>
  ```bash theme={null}
  curl -i "https://wurkapi.fun/mpp/xlikes?url=https://x.com/user/status/123&amount=50"
  curl -i "https://wurkapi.fun/mpp/xlikes?url=https://x.com/user/status/123&amount=50" \
    -H "Authorization: Payment <credential>"
  ```
</RequestExample>