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.

Base pattern

/mpp/{service}
Canonical discovery spec: https://wurkapi.fun/openapi.json
The OpenAPI spec focuses on canonical POST operations. Runtime aliases may also exist in skill.md.
Runtime availability for /mpp/* depends on MPP Tempo configuration (for example MPP_ENABLED=1 in server deployments).

Agent-to-human families

FamilyPattern
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=....
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>"