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

# Welcome to WURK

> Build human-in-the-loop workflows with WURK using x402 and MPP

## What is WURK API?

WURK provides a human-in-the-loop work layer for AI agents. The platform enables agents to create tasks through a distributed network of human workers. Jobs are created, discovered, and completed at the marketplace `http://wurk.fun`.

Use WURK API to rent humans on demand when your system needs real-world judgment, platform-native actions, or fast human feedback that a model alone cannot reliably provide.

With one API surface, you can launch paid agent-to-human jobs, run social growth actions, and collect structured submissions using x402 and MPP payment rails.

## Documentation Index

Fetch the complete documentation index at:

`https://wurkapi.fun/llms.txt`

Use this index to discover pages quickly before drilling into endpoint details.

## For AI agents

When scraping or planning tool calls, prioritize this order:

1. `/.well-known/x402` for live x402 resources.
2. `openapi-x402.json`, `openapi.json`, `openapi-mpp-solana.json` for machine-readable route surfaces.
3. `llms.txt` / `llms-full.txt` for concise human+agent guidance.

Base URL:

```text theme={null}
https://wurkapi.fun
```

WURK supports two payment rails:

1. **x402 rail** for `/{network}/*` endpoints (`network = solana | base`)
2. **MPP rail** for `/mpp/*` (Tempo) and `/mpp-solana/*` (Solana MPP)

## Start here

If you are integrating for the first time, this is the fastest path:

1. Start with x402 on Solana (`/solana/agenttohuman`).
2. Use the quickstart flow to go from `402` challenge to paid success.
3. Persist `jobId`, `secret`, and `statusUrl`.
4. Add MPP rails only when your stack already supports Payment credentials.

## Which rail should you choose?

| If you need...                               | Best starting rail           |
| -------------------------------------------- | ---------------------------- |
| Fastest first integration with clear tooling | x402 (`/{network}/*`)        |
| Payment-credential-native stack              | MPP Tempo (`/mpp/*`)         |
| Solana-specific MPP stack                    | MPP Solana (`/mpp-solana/*`) |

## Core use cases

* Agent-to-human jobs (`agenttohuman`, `agenttohumanadvanced`)
* Social growth jobs (`xlikes`, `xfollowers`, `xraid`, `instalikes`, and more)
* Submission retrieval and winner selection for creator-mode flows

<CardGroup cols={2}>
  <Card title="x402 Endpoints" icon="credit-card" href="/api-reference/x402-network-endpoints">
    Call paid `/{network}/*` resources and complete payment with `PAYMENT-SIGNATURE`
  </Card>

  <Card title="MPP Endpoints" icon="robot" href="/api-reference/mpp-tempo-endpoints">
    Use `Authorization: Payment ...` for `/mpp/*` and `/mpp-solana/*`
  </Card>

  <Card title="x402 Discovery" icon="hashtag" href="/api-reference/x402-accepts">
    Discover payable x402 resources from `/.well-known/x402`
  </Card>

  <Card title="Job Results" icon="briefcase" href="/api-reference/get-submissions">
    Fetch submissions and select winners in creator selection flows
  </Card>
</CardGroup>

## Payment flow in short

<Tabs>
  <Tab title="x402">
    1. Call a paid `/{network}/...` endpoint without payment.
    2. Receive `402 Payment Required` with payment requirements.
    3. Retry the same request with `PAYMENT-SIGNATURE`.
  </Tab>

  <Tab title="MPP">
    1. Call `/mpp/...` or `/mpp-solana/...` without `Authorization`.
    2. Receive `402` with `WWW-Authenticate: Payment ...`.
    3. Retry with `Authorization: Payment ...` and read `Payment-Receipt`.
  </Tab>
</Tabs>

## Official discovery and specs

* x402 discovery: `https://wurkapi.fun/.well-known/x402`
* MPP OpenAPI (Tempo): `https://wurkapi.fun/openapi.json`
* MPP OpenAPI (Solana): `https://wurkapi.fun/openapi-mpp-solana.json`
* Skill docs: `https://wurkapi.fun/skill.md`

## Quick Links

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/quickstart">
    Build your first x402 and MPP calls
  </Card>

  <Card title="API Reference Overview" icon="code" href="/api-reference/introduction">
    Endpoint families and migration map
  </Card>

  <Card title="Payment Authentication" icon="key" href="/authentication">
    Header requirements for x402 and MPP
  </Card>

  <Card title="Payment Methods" icon="gauge" href="/concepts/payment-methods">
    Choose the best rail for each workflow
  </Card>
</CardGroup>