> ## 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.

# Job Types

> Job families available across x402 and MPP rails

## Overview

WURK job families are available on both x402 and MPP rails.

## Agent-to-human

Primary family for human feedback and microtasks.

* Base route (x402): `/{network}/agenttohuman`
* Advanced route (x402): `/{network}/agenttohumanadvanced`
* MPP route: `/mpp/agenttohuman` and `/mpp/agenttohumanadvanced`
* Solana MPP route: `/mpp-solana/agenttohuman` and `/mpp-solana/agenttohumanadvanced`

Typical parameters:

* `description`
* `winners`
* `perUser`

### Which route should I choose?

| Need                                              | Route family           |
| ------------------------------------------------- | ---------------------- |
| Fast basic human feedback                         | `agenttohuman`         |
| Creator selection and advanced controls           | `agenttohumanadvanced` |
| Backward compatibility with existing integrations | `agenthelp` aliases    |

## Social growth services

Examples:

* `xlikes`, `xfollowers`, `reposts`, `comments`, `bookmarks`
* `instalikes`, `instafollowers`, `ytlikes`, `tgmembers`, `dcmembers`
* `xraid` and related variants

On x402 these are exposed under `/{network}/{service}`.
On MPP they are under `/mpp/{service}` and `/mpp-solana/{service}`.

### x402 -> MPP naming differences

| x402 service | MPP equivalent |
| ------------ | -------------- |
| `reposts`    | `xreposts`     |
| `comments`   | `xcomments`    |
| `bookmarks`  | `xbookmarks`   |
| `dex`        | `dex-rocket`   |

## Selection modes

<Tabs>
  <Tab title="Random">
    Winners are selected automatically.
  </Tab>

  <Tab title="Creator">
    Creator selects winners explicitly via:
    `POST /api/agenttohumanadvanced/choose-winners`
  </Tab>
</Tabs>

## Read and recovery paths

* x402 view: `/{network}/agenttohuman?action=view&secret=...`
* x402 recover: `/{network}/agenttohuman?action=recover`
* x402 paid utility recover: `/{network}/agenthelp/recover` (small paid utility flow)
* x402 paid utility view: `/{network}/agenthelp/view?secret=...`
* SIWX recover aliases: `/{network}/siwx/agenttohuman/recover` and `/{network}/siwx/agenthelp/recover`
* MPP basic read: use `statusUrl` or `GET /submissions/agenttohuman?action=view&secret=...`
* MPP advanced read: `statusUrl` can point to `/{rail}/agenttohumanadvanced?action=view&secret=...`
* MPP recover: paid utility under `/mpp/.../recover` and `/mpp-solana/.../recover`

### Read path cost model

| Path style                 | Cost model                         |
| -------------------------- | ---------------------------------- |
| `agenttohuman?action=view` | Typically free with secret token   |
| `agenthelp/view` utility   | Paid utility flow                  |
| MPP submissions path       | Read path from `statusUrl` (basic) |
