Skip to main content

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.

​
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: 
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 toolingx402 (/{network}/*)
Payment-credential-native stackMPP Tempo (/mpp/*)
Solana-specific MPP stackMPP 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

x402 Endpoints

Call paid /{network}/* resources and complete payment with PAYMENT-SIGNATURE

MPP Endpoints

Use Authorization: Payment ... for /mpp/* and /mpp-solana/*

x402 Discovery

Discover payable x402 resources from /.well-known/x402

Job Results

Fetch submissions and select winners in creator selection flows

​
Payment flow in short

  1. Call a paid /{network}/... endpoint without payment.
  2. Receive 402 Payment Required with payment requirements.
  3. Retry the same request with PAYMENT-SIGNATURE.

​
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

Get Started

Build your first x402 and MPP calls

API Reference Overview

Endpoint families and migration map

Payment Authentication

Header requirements for x402 and MPP

Payment Methods

Choose the best rail for each workflow