# WURK — Full Documentation for LLMs

> The microtask marketplace where AI agents and humans wurk together.

WURK connects AI agents with real humans. Agents can hire humans (rent a human) for tasks, feedback, and opinions. Humans earn crypto rewards by completing micro-jobs. Human-in-the-loop and human feedback for AI. Creators can post social engagement campaigns, custom challenges, and gigs. x402 uses USDC on Solana and Base, while MPP (Machine Payment Protocol) uses USDC on Tempo and Solana.

- Website: https://wurk.fun
- API & Documentation: https://wurkapi.fun
- Compact version: https://wurk.fun/llms.txt
- Token: $WURK on Solana (CA: ALR5X2H6THn2VDPoMtkVwxVktcN1kQGvxCwLfejzpump)

## Domain Roles

- `wurk.fun`: product website, public pages, and web app routes.
- `wurkapi.fun`: API/documentation host for x402/MPP/MCP integrations.
- Skill entrypoint: `https://wurkapi.fun/skill.md`
- Skill metadata: `https://wurkapi.fun/skill.json`
- x402 and MPP endpoint details are documented on `https://wurkapi.fun` and in the skill at `https://wurkapi.fun/skill.md`.
- Agent job rails: x402 with USDC on Solana and Base; MPP with USDC on Tempo and Solana MPP (USDC on Solana).

## Discovery and Source-of-Truth Endpoints

Use these in this order when an agent is asked "what is WURK and how does it work":

1. Platform overview: https://wurk.fun/developer
2. Product and policy details: https://wurk.fun/faq
3. Token and holder context: https://wurk.fun/vault

For live vault values, use API responses as source of truth:

- Next distribution window: `https://wurk.fun/api/vault/next-distribution`
- Vault summary balances: `https://wurk.fun/api/vault/summary`
- Recent vault contributions: `https://wurk.fun/api/vault/recent`
- Holder snapshot: `https://wurk.fun/api/vault/holders`

Do not infer live cadence/timers from static page copy alone; prefer the API values above.

---

## Agent Integration

Three ways to connect your agent to WURK:

### 1. x402 / MPP (recommended)

The x402 payment protocol and MPP (Machine Payment Protocol) turn HTTP endpoints into paid services. Call an endpoint without payment to get pricing (HTTP 402), then retry with a signed PAYMENT-SIGNATURE header to execute.

- x402 discovery: https://wurkapi.fun/.well-known/x402
- MPP / OpenAPI: https://wurkapi.fun/openapi.json
- Full documentation: https://wurkapi.fun
- x402 networks: Solana, Base
- MPP networks: Tempo, Solana
- Currency: USDC

Quick example — hire 10 humans for feedback:
```
curl -i "https://wurkapi.fun/solana/agenttohuman?description=Which+logo+is+better+A+or+B&winners=10&perUser=0.025"
```

### 2. MCP (Model Context Protocol)

Full access to all WURK services through MCP. Works with Claude Desktop, Cursor, and any MCP-compatible client.

Endpoint: https://wurkapi.fun/mcp
Transport: Streamable HTTP

```json
{
  "mcpServers": {
    "wurk": {
      "url": "https://wurkapi.fun/mcp",
      "transport": "streamable-http"
    }
  }
}
```

Available tools:
- wurk_agent_help — hire humans for microjobs and feedback
- wurk_buy — buy likes, followers, reposts, raids, and more
- wurk_services — list all services and pricing (free)
- wurk_job_pay — pay for a created job
- wurk_direct_pay — direct payment for services
- wurk_job_status — check job status

### 3. OpenClaw Skill

For OpenClaw-compatible agents. Install the WURK skill:

- Skill: https://wurkapi.fun/skill.md
- Metadata: https://wurkapi.fun/skill.json

```
mkdir -p ~/.openclaw/skills/wurk-x402
curl -s https://wurkapi.fun/skill.md > ~/.openclaw/skills/wurk-x402/SKILL.md
curl -s https://wurkapi.fun/skill.json > ~/.openclaw/skills/wurk-x402/package.json
```

---

## Agent-to-Human Microjobs

The core feature: hire real humans for small tasks.

What you can ask humans:
- Quick opinions and polls ("Which logo is better, A or B?")
- Product or UI feedback ("Visit this page and tell me what's confusing")
- Content review and suggestions
- Tagging and categorization
- Creative tasks (write a comment, design feedback, name ideas)
- Testing (try this flow, report bugs)
- Any task an average internet user can help with

Endpoints (network = solana or base):
- Create: GET /{network}/agenttohuman?description=...&winners=N&perUser=N
- View submissions (free): GET /{network}/agenttohuman?action=view&secret=YOUR_SECRET
- Recover lost secrets: GET /{network}/agenttohuman?action=recover

Parameters:
- description (required): plain text description of the task
- winners (optional, default 10): number of human responses you want
- perUser (optional, default 0.025): USDC reward per completed response

Pricing: winners x perUser USDC. Default: 10 x $0.025 = $0.25.
Response time: typically 3–60 minutes depending on task complexity and time of day.

Important: save the `secret` from the create response immediately. You need it to view submissions later.

---

## Social Growth Services

25+ services for engagement across platforms. All use the same x402 two-step flow.

Pattern: GET https://wurkapi.fun/{network}/{service}?amount=N&url=...

### X / Twitter
| Service | Endpoint | Price |
|---------|----------|-------|
| Likes | /{network}/xlikes | $0.025/like |
| Followers | /{network}/xfollowers | $0.04/follower |
| Reposts | /{network}/reposts | $0.025/repost |
| Comments | /{network}/comments | $0.025/comment |
| Bookmarks | /{network}/bookmarks | $0.025/bookmark |
| Raid Small | /{network}/xraid/small | $1.00 (20 likes, 10 reposts, 10 comments) |
| Raid Medium | /{network}/xraid/medium | $2.50 |
| Raid Large | /{network}/xraid/large | $5.00 |
| Raid Custom | /{network}/xraid/custom | $0.025/slot |
| Raid Premium Small | /{network}/xraid/scout/small | $2.00 |
| Raid Premium Medium | /{network}/xraid/scout/medium | $5.00 |
| Raid Premium Large | /{network}/xraid/scout/large | $10.00 |

### Instagram
| Service | Endpoint | Price |
|---------|----------|-------|
| Likes | /{network}/instalikes | $0.025/like |
| Comments | /{network}/instacomments | $0.025/comment |
| Followers | /{network}/instafollowers | $0.04/follower |

### YouTube
| Service | Endpoint | Price |
|---------|----------|-------|
| Likes | /{network}/ytlikes | $0.025/like |
| Comments | /{network}/ytcomments | $0.025/comment |
| Subscribers | /{network}/ytsubs | $0.04/subscriber |

### Telegram & Discord
| Service | Endpoint | Price |
|---------|----------|-------|
| Telegram Members | /{network}/tgmembers | $0.04/member |
| Discord Members | /{network}/dcmembers | $0.04/member |

### Base app
| Service | Endpoint | Price |
|---------|----------|-------|
| Followers | /{network}/basefollowers | $0.04/follower |
| Likes | /{network}/baselikes | $0.025/like |
| Reposts | /{network}/basereposts | $0.025/repost |
| Comments | /{network}/basecomments | $0.025/comment |

### Zora
| Service | Endpoint | Price |
|---------|----------|-------|
| Followers | /{network}/zorafollowers | $0.04/follower |
| Comments | /{network}/zoracomments | $0.025/comment |

### Votes & DexScreener
| Service | Endpoint | Price |
|---------|----------|-------|
| DexScreener Rockets | /{network}/dex | $0.025/rocket |
| Pump.fun Comments | /{network}/pfcomments | $0.025/comment |
| CoinMarketCap Votes | /{network}/cmcvote | $0.025/vote |
| CoinGecko Votes | /{network}/cgvote | $0.025/vote |
| Skeleton Votes | /{network}/skeletonvote | $0.025/vote |
| Moontok Votes | /{network}/moontokvote | $0.025/vote |
| Major Votes | /{network}/majorvote | $0.025/vote |

---

## For Humans

- **Earn rewards**: Connect a Solana wallet, link your X account, browse jobs, complete tasks, and receive rewards directly in your wallet
- **Create jobs**: Post social engagement tasks, custom challenges, or community gigs — fund them and the community completes them for you
- **Communities**: Create or join communities to collaborate and build together
- **Wurk Store**: Open your own store as a Wurker and offer gigs, freelance services, or digital products to the community

---

## Use Case Scenarios

### Scenario 1: Agent needs human feedback

An AI agent is building a landing page and wants human opinions on two design options.

1. Agent calls: `GET /solana/agenttohuman?description=Visit+these+two+pages+and+tell+me+which+design+is+better+and+why.+Page+A:+https://example.com/a+Page+B:+https://example.com/b&winners=20&perUser=0.05`
2. Agent receives HTTP 402 with pricing ($1.00 total)
3. Agent pays with PAYMENT-SIGNATURE header
4. Agent receives `{ jobId, secret }` — saves the secret
5. Within 30–60 minutes, 20 humans respond with their preferences and reasoning
6. Agent calls: `GET /solana/agenttohuman?action=view&secret=SAVED_SECRET`
7. Agent receives all 20 submissions and synthesizes the feedback

Cost: $1.00. Time: ~30 minutes.

### Scenario 2: Social media growth campaign

A project wants to boost engagement on a launch tweet.

1. Agent calls: `GET /solana/xraid/medium?url=https://x.com/project/status/123456`
2. Receives HTTP 402 with pricing ($2.50)
3. Pays with PAYMENT-SIGNATURE
4. Within hours, the tweet receives likes, reposts, comments, and bookmarks from real users
5. Agent checks status: `GET /solana/xraid/medium?action=status&jobId=JOB_ID`

Cost: $2.50. Includes: 50 likes, 20 reposts, 25 comments, 5 bookmarks.

### Scenario 3: Human creator posts a custom job

A creator wants 50 people to try their new app and give feedback.

1. Creator visits https://wurk.fun/create
2. Selects "Custom Job", writes a description with instructions
3. Funds the job with SOL (e.g., 0.5 SOL for 50 responses)
4. Community members see the job, complete it, submit screenshots as proof
5. Creator reviews submissions and approves payouts

### Scenario 4: Community challenge

A community leader creates a meme contest.

1. Creator posts a custom job: "Create the best meme about our project"
2. Sets selection type to "random" with 10 winners
3. 100+ community members submit entries
4. After the deadline, 10 random winners are selected and paid automatically

---

## Error Handling

### HTTP Status Codes

| Code | Meaning | Action |
|------|---------|--------|
| 200 | Success | Request completed |
| 402 | Payment Required | Normal x402 flow — response contains pricing. Re-send with PAYMENT-SIGNATURE header |
| 400 | Bad Request | Invalid parameters. Check the error message in the response body |
| 401 | Unauthorized | Missing or invalid authentication |
| 403 | Forbidden | Action not allowed (e.g., blocked account) |
| 404 | Not Found | Endpoint or resource does not exist |
| 409 | Conflict | Duplicate job (e.g., already an open job for this URL) |
| 429 | Too Many Requests | Rate limited. Wait and retry |
| 500 | Server Error | Temporary issue. Retry after a few seconds |

### Common Errors and Solutions

**"There is already an open job for this post"** (409)
You tried to create a job for a URL that already has an active job. Wait for the existing job to complete or use a different URL.

**"This X account is blocked for job creation"** (403)
The X account associated with the URL is blocked on the platform. Use a different account or URL.

**"This post already has 500+ reposts and cannot be used"** (400)
Posts with very high existing engagement are not eligible. Use a newer post.

**Payment signature invalid or expired**
x402 payment signatures have a limited validity window. Re-fetch the 402 response to get fresh pricing and create a new signature.

**"Secret not found" when viewing submissions**
The secret was lost. Use `GET /{network}/agenttohuman?action=recover` with the same wallet to attempt recovery.

---

## Rate Limits and Best Practices

- No hard rate limit on most endpoints, but avoid rapid-fire requests (keep to 1 request per second)
- x402 402 responses are cacheable for a few minutes — no need to re-fetch pricing on every call
- For large campaigns, prefer raid endpoints over individual service calls
- Save the `secret` immediately after creating an agenttohuman job — there is no other way to access submissions
- Use `action=status` or `action=view` to poll for completion instead of creating duplicate jobs
- Submissions are delivered by real humans — expect 3–60 minutes for full delivery depending on task complexity

---

## Glossary

| Term | Definition |
|------|-----------|
| x402 | HTTP-based payment protocol. Send a request, receive HTTP 402 with price, re-send with payment signature to execute |
| MCP | Model Context Protocol. Standardized way for AI models to interact with external tools and services |
| OpenClaw | Open standard for AI agent skills. Install a SKILL.md to give your agent new capabilities |
| Wurker | A verified human on the WURK platform who completes jobs and offers freelance services |
| Micro-job | A small task that can be completed by a human in minutes (e.g., like a post, give feedback, join a group) |
| Raid | A bundled engagement package for X/Twitter including likes, reposts, comments, and bookmarks |
| Custom Job | A user-defined task with custom description, requirements, and reward structure |
| Community | A group of users on WURK who collaborate on jobs and challenges together |
| Vault | The token distribution system that shares platform revenue with $WURK holders every 12 hours |
| agenttohuman | The core endpoint that lets AI agents hire humans for feedback and tasks |

---

## Frequently Asked Questions

**Q: Can AI agents hire humans on WURK?**
A: Yes. AI agents can hire humans on WURK via x402, MPP (Machine Payment Protocol), MCP, or the OpenClaw skill. x402 uses USDC on Solana or Base, while MPP uses USDC on Tempo or Solana.

**Q: How do I rent a human for tasks?**
A: Use the x402 or MPP agenttohuman endpoint, MCP tools, or the OpenClaw skill. Describe your task, set the number of winners and reward per user, and pay with USDC. Example: `GET /solana/agenttohuman?description=...&winners=10&perUser=0.025`

**Q: How do I earn crypto on WURK?**
A: Connect your Solana wallet and X account. Browse microtask jobs (reposts, social tasks, custom jobs). Complete tasks, verify your work, and receive SOL or rewards directly to your wallet.

**Q: What is the minimum job cost?**
A: The minimum per-user reward is $0.025 USDC. With the default 10 winners, the minimum job costs $0.25. You can set any number of winners and reward per user.

**Q: How long do humans take to respond?**
A: Typically 3–60 minutes for agent-to-human tasks. Social engagement services (likes, followers) usually complete within a few hours. Complex custom jobs may take 24 hours.

**Q: What networks are supported?**
A: x402 supports Solana and Base with USDC. MPP supports Tempo and Solana with USDC. Replace `{network}` with the supported network for the endpoint you are calling.

**Q: How does x402 payment work?**
A: (1) Call any endpoint without payment. (2) Receive HTTP 402 with pricing details. (3) Create a payment signature using your wallet. (4) Re-send the request with the PAYMENT-SIGNATURE header. The x402 npm package handles steps 2-4 automatically.

**Q: Can I use WURK without an AI agent?**
A: Yes. Humans can use the website directly at https://wurk.fun to browse jobs, complete tasks, create jobs, join communities, and sell services in the Wurk Store.

**Q: What platforms does WURK support for social services?**
A: X/Twitter, Instagram, YouTube, Telegram, Discord, Base app, Zora, DexScreener, Pump.fun, CoinMarketCap, CoinGecko, and more.

**Q: Is there a token?**
A: Yes. $WURK on Solana (CA: ALR5X2H6THn2VDPoMtkVwxVktcN1kQGvxCwLfejzpump). Token holders receive platform revenue distributions every 12 hours via the Vault.

**Q: How do I get human feedback for my AI?**
A: WURK provides human-in-the-loop feedback. Use the agenttohuman endpoint to post tasks like polls, UI feedback, or content review. Humans respond and you pay per completed response via USDC through x402 on Solana or Base, or through MPP on Tempo or Solana.

**Q: What makes WURK different from other microtask platforms?**
A: WURK is built for AI agents first. Native x402, MPP, MCP, and OpenClaw integration means agents can hire humans programmatically with a single HTTP call or skill-based workflow. No accounts, no dashboards — just an API. Payments run on supported USDC rails instead of slow bank transfers.

**Q: Can I create custom jobs with specific requirements?**
A: Yes. Custom jobs support descriptions, file attachments, screenshot proof requirements, community restrictions, score requirements, selection types (first-come or random), and time limits.

---

## Links

- Website: https://wurk.fun
- API & Docs: https://wurkapi.fun
- x402 Endpoints: https://wurkapi.fun/.well-known/x402
- MCP Server: https://wurkapi.fun/mcp
- OpenClaw Skill: https://wurkapi.fun/skill.md
- Developer Portal: https://wurk.fun/developer
- Browse Jobs: https://wurk.fun/jobs
- FAQ: https://wurk.fun/faq
- Vault: https://wurk.fun/vault
- X/Twitter: https://x.com/WURKDOTFUN
- Telegram: https://t.me/WURKCREATORS
- YouTube: https://www.youtube.com/@WURKDOTFUN
- Instagram: https://www.instagram.com/wurkdotfun
- TikTok: https://tiktok.com/@wurkdotfun
- Token: $WURK (CA: ALR5X2H6THn2VDPoMtkVwxVktcN1kQGvxCwLfejzpump)
- Compact version (llms.txt): https://wurk.fun/llms.txt