Allows AI agents to hire real people for data collection, app testing, and human judgment tasks.
Also known as RapidWorkers-io/rapidworkers, rapidworkers-mcp
- Stars
- 0
- Tools
- 22
- Downloads, 30 days
- 135
- Latest version
- 0.1.0
- Last commit
- Nov 10, 2026
- License
- MIT
What is RapidWorkers MCP?
RapidWorkers allows AI agents to hire real people for data collection, app testing, and human judgment tasks. It exposes 22 tools, such as get_account, get_platform_info, list_transactions.
Summary generated from the project's README
About RapidWorkers MCP server
RapidWorkers enables AI agents to bridge the gap between digital processes and human reality by hiring real people for micro-tasks. This server allows agents to request data collection, real-device app testing, and human judgment tasks such as native-speaker checks or usability feedback. Developers can use the hosted server via HTTP with OAuth or run local stdio relays using Python, JavaScript, Rust, or Go packages.
To use the service, you must provide a RAPIDWORKERS_API_KEY. The workflow involves getting a cost quote through preview tools, confirming the job, and then reviewing submissions to approve or reject them. The system enforces specific financial constraints, including a minimum deposit of $20, a minimum of 10 workers per job, and specific pay rates ranging from $0.05 to $0.50 per task depending on the job type. Once a submission is approved, the payment is final, though pending items are automatically approved after two days.
What you can do with it
- 1Gathering diverse training dataAsk an AI agent to collect specific photos, audio, or video files based on a provided brief.
- 2Testing mobile applicationsInstruct an agent to have real people install an app on their own devices to report bugs and provide screenshots.
- 3Verifying linguistic accuracyRequest human judgment to perform native-speaker checks on generated text.
- 4Budgeting for micro-tasksHave an agent calculate the total cost for a specific quantity of tasks before committing to a job.
Written from the project's README. Every use case is checked against a quote from it.
How to install RapidWorkers MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall RapidWorkers MCP in Claude Code
$ claude mcp add --env 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' rapidworkers -- npx -y rapidworkers-mcpInstall RapidWorkers MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"rapidworkers": {
"command": "npx",
"args": [
"-y",
"rapidworkers-mcp"
],
"env": {
"RAPIDWORKERS_API_KEY": "<YOUR_RAPIDWORKERS_API_KEY>"
}
}
}
}Install RapidWorkers MCP in VS Code
.vscode/mcp.json
{
"servers": {
"rapidworkers": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rapidworkers-mcp"
],
"env": {
"RAPIDWORKERS_API_KEY": "<YOUR_RAPIDWORKERS_API_KEY>"
}
}
}
}Install RapidWorkers MCP in VS Code CLI
$ code --add-mcp '{"name":"rapidworkers","type":"stdio","command":"npx","args":["-y","rapidworkers-mcp"],"env":{"RAPIDWORKERS_API_KEY":"<YOUR_RAPIDWORKERS_API_KEY>"}}'Install RapidWorkers MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"rapidworkers": {
"command": "npx",
"args": [
"-y",
"rapidworkers-mcp"
],
"env": {
"RAPIDWORKERS_API_KEY": "<YOUR_RAPIDWORKERS_API_KEY>"
}
}
}
}Install RapidWorkers MCP in Codex
$ codex mcp add rapidworkers --env 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' --env 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' --env 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' --env 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' -- npx -y rapidworkers-mcpInstall RapidWorkers MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.rapidworkers] command = "npx" args = ["-y", "rapidworkers-mcp"] [mcp_servers.rapidworkers.env] RAPIDWORKERS_API_KEY = "<YOUR_RAPIDWORKERS_API_KEY>"
Install RapidWorkers MCP in Gemini CLI
$ gemini mcp add -s user -e 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' -e 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' -e 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' -e 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' rapidworkers npx -- -y rapidworkers-mcpInstall RapidWorkers MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"rapidworkers": {
"command": "npx",
"args": [
"-y",
"rapidworkers-mcp"
],
"env": {
"RAPIDWORKERS_API_KEY": "<YOUR_RAPIDWORKERS_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for rapidworkers-mcp 0.1.0 in an isolated container with no network and no keys. It answered and listed 22 tools.
RapidWorkers MCP tools 22
Read from the server with tools/listget_accountRead-onlyReturns the account balance (USD), whether the account has made a deposit (required before posting jobs), AI task access status and the commission rate added to job costs.
get_platform_infoRead-onlyReturns platform rules (minimum pay $0.05 per task, $0.10 for AI tasks, $0.50 per survey response, at least 10 workers per job, $20 minimum deposit, commission and fees), job categories with sub-category codes, the prefilled job types with the link each one expects, AI task types, the survey builder options (question types, scale presets, attention check templates, limits and audience codes) and the allowed ISO country codes. Call it before creating a job or survey.
list_transactionsRead-onlyReturns the 20 most recent balance transactions (deposits, job charges, refunds).
get_deposit_linkActionCreates a hosted checkout page and returns its URL for the account owner to open and pay. It does not charge anything by itself. Minimum $20. method "card" (Stripe; a 4% processing fee is deducted from the credited amount) or "crypto". The balance is credited only after payment completes; check get_account afterwards.
preview_job_costRead-onlyCalculates the exact charge for a job, survey or AI task before creating it: pay rate x quantity + commission (+ $10 if a regular job is pinned), whether the balance covers it, and a quote_id valid for 10 minutes. Every create tool requires this quote_id, so call this first with the kind you will create ("job", "survey" or "ai_task") and show the total to the user. Rules: pay_rate >= 0.05 (>= 0.10 for kind "ai_task", >= 0.50 for kind "survey"), quantity >= 10 (at most 20,000 for AI tasks and surveys), pin only for kind "job".
create_jobActionPosts a custom job that real workers complete and prove with a screenshot or text. Charges pay_rate x quantity + commission from the balance immediately. Requires quote_id from preview_job_cost, confirm=true after the user approved the total, and an idempotency_key (a new unique string; reuse it only to retry after a timeout). pay_rate >= 0.05 in every category, quantity >= 10. New jobs may be held for a short moderation review before going live. Optional image_prompt: a detailed description of one image we generate with AI and show workers on the job page.
create_prefilled_jobActionPosts a ready-made job from a link, e.g. Instagram followers or YouTube likes; get_platform_info lists the types and the link each expects. Charges pay_rate x quantity + commission. Requires quote_id from preview_job_cost (kind "job"), confirm=true and an idempotency_key. pay_rate >= 0.05 (default 0.05), quantity >= 10. Set approve_once_full=true to approve all submissions automatically once the job is full. Optional image_prompt: a detailed description of one image we generate with AI and show workers.
create_surveyActionPosts a survey that real workers answer on RapidWorkers, built from your questions (choice, dropdown, rating with stars, agree scales or NPS, matrix, ranking, text, number, date, consent, text blocks and attention checks), and charges pay_rate x quantity + commission. No extra access is needed. Requires quote_id from preview_job_cost with kind "survey", confirm=true and an idempotency_key. pay_rate >= 0.50 per response, quantity 10 to 20,000, countries required. Questions are keyed q_1, q_2, ... by position (text blocks count): show_if may only point at an earlier question. Up to 5 screening questions must come first; screened-out workers are not paid and free their slot. Add 1 attention check (2 for surveys over 5 minutes). Every response gets a quality score; failed attention checks, impossible speed and repeat devices are rejected automatically. Optional image_prompt: one image we generate with AI and show workers with the survey intro.
create_ai_taskActionPosts an AI data-collection task (image, video, audio or text collection, or a custom form) and charges pay_rate x quantity + commission. Requires approved AI task access (see request_ai_task_access), quote_id from preview_job_cost with kind "ai_task", confirm=true and an idempotency_key. pay_rate >= 0.10, quantity 10 to 20,000, countries required. Optional image_prompt: a detailed description of one example image we generate with AI and attach as a reference file.
request_ai_task_accessActionSends a request to enable AI data-collection tasks for this account, or returns the current status. An admin reviews requests; until approved, create_ai_task fails.
list_jobsRead-onlyLists the account's jobs with status (Pending, Active, Completed, Canceled, Rejected), progress and pending submission counts, newest first. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
get_jobRead-onlyReturns one job, survey or AI task by id with its brief, pay, targeting and progress; for a survey also its questions (keys q_1, q_2, ... with option ids), audience, response counts and quality bands. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
Show all 22 toolsShow fewer tools
extend_jobActionAdds worker slots to a job and charges pay_rate x additional_quantity + commission. Regular jobs can only be extended once completed; surveys and AI tasks can have at most 20,000 slots in total. Requires confirm=true and an idempotency_key. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
cancel_jobActionCancels a job and refunds the unspent budget to the balance. Pending (not yet live) jobs are refunded in full; live jobs pay a $0.20 fee and cannot be canceled while submissions await review. Requires confirm=true. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
list_submissionsRead-onlyLists submissions for a job, newest first, filtered by status (Pending, Approved, Rejected). Each has the proof text, proof image links and the worker's approval rate. For kind "survey" each response has its answers (question key, label and the answer as text), a quality score (0-100), a quality band (good, check, likely_bad) with the flags behind it, and whether it was rejected automatically; quality_band filters by band. Paginated with page and page_size (max 100). Pending submissions are approved automatically after 2 days if not reviewed. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
get_survey_resultsRead-onlyReturns the aggregated results of a survey (job_id from create_survey or list_jobs with kind "survey"): the response funnel (started, screened out, submitted, pending, approved, rejected), median time and effective hourly pay, quality bands, and per question the answer counts and percentages, means and medians, the NPS score, rankings, number ranges and the latest text answers. include "valid" (default: pending and approved responses), "approved" or "all" (adds rejected); screened-out workers never count. For each response in full use list_submissions with kind "survey".
approve_submissionActionApproves a submission and pays the worker from the job budget; this cannot be undone. Optional tip $0.01 to $50.00 from the balance, paid to the worker in full. Requires an idempotency_key. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
reject_submissionActionRejects a Pending submission; the worker is not paid and sees the reason. Never reject an Approved submission: it has already been paid, and rejecting it does not take the payment back. reason is required and should say exactly what was missing. Requires an idempotency_key. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
approve_all_pendingActionApproves every Pending submission on the job and pays the workers; this cannot be undone. For a survey, only_quality_band "good" approves only the Pending responses in the good quality band and leaves the rest for review. Requires confirm=true and an idempotency_key. Set kind to "survey" for surveys made with create_survey or "ai_task" for AI data-collection tasks; the default "job" covers regular and prefilled jobs.
block_workerActionBlocks a worker (worker_id from list_submissions of a regular job or a survey) from all of the account's jobs and rejects their pending submissions.
unblock_workerActionRemoves a worker from the block list.
list_blocked_workersRead-onlyLists the workers this account has blocked.
Configuration
RAPIDWORKERS_API_KEYRequiredSecretAPI key from https://www.rapidworkers.io/dashboard/api-management/
RAPIDWORKERS_API_KEYRequiredSecretAPI key from https://www.rapidworkers.io/dashboard/api-management/
RAPIDWORKERS_API_KEYRequiredSecretAPI key from https://www.rapidworkers.io/dashboard/api-management/
RAPIDWORKERS_API_KEYRequiredSecretAPI key from https://www.rapidworkers.io/dashboard/api-management/
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablerapidworkers-io/rapidworkers is public and reachablegithub.com/rapidworkers-io/rapidworkers ↗Pass
- Package names this repository as its sourcerapidworkers-mcp, rapidworkers-mcp name rapidworkers-io/rapidworkers as sourcenpmjs.com/package/rapidworkers-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for rapidworkers-mcppypi.org/project/rapidworkers-mcp/ ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/rapidworkers-io/rapidworkers ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from rapidworkers-mcp, rapidworkers-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubRapidWorkers SDKs and MCP server
RapidWorkers lets software and AI agents hire real people for small paid tasks done on their own devices:
- AI data collection: photos, audio, video and text gathered to your brief.
- Real-device testing: people install your app or open your site and report what broke, with screenshots.
- Human judgment: native-speaker checks, surveys, usability and first-impression feedback.
You get a cost quote, confirm it, post the task, then review each submission and approve (pay) or reject it. This repository holds the official clients. Every one of them talks to the hosted MCP server at https://www.rapidworkers.io/api/mcp/, so they all share the same tools, validation and safeguards.
Packages
| Language | SDK | MCP server for local clients |
|---|---|---|
| Python | pip install rapidworkers |
uvx rapidworkers-mcp |
| JavaScript / TypeScript | npm install rapidworkers |
npx -y rapidworkers-mcp |
| Rust | cargo add rapidworkers |
cargo install rapidworkers-mcp |
| Go | go get github.com/RapidWorkers-io/rapidworkers/go |
go install github.com/RapidWorkers-io/rapidworkers/go/cmd/rapidworkers-mcp@latest |
| Docker | docker run -i --rm -e RAPIDWORKERS_API_KEY ghcr.io/rapidworkers-io/rapidworkers-mcp |
|
| Claude Desktop | One-click extension: download rapidworkers-mcp-<version>.mcpb from Releases and open it |
All of them need an API key from https://www.rapidworkers.io/dashboard/api-management/, passed as RAPIDWORKERS_API_KEY.
Connect an AI agent
The easiest way is the hosted server, with OAuth sign-in and nothing to install:
claude mcp add --transport http rapidworkers https://www.rapidworkers.io/api/mcp/
For clients that launch local servers (Claude Desktop, Cursor, Windsurf, Cline, Zed...):
{
"mcpServers": {
"rapidworkers": {
"command": "npx",
"args": ["-y", "rapidworkers-mcp"],
"env": { "RAPIDWORKERS_API_KEY": "your-api-key" }
}
}
}
Use it from code
from rapidworkers import RapidWorkers
rw = RapidWorkers()
quote = rw.preview_job_cost(kind="ai_task", pay_rate=0.25, quantity=100)
print(quote["total"]) # confirm the cost before creating anything
import { RapidWorkers } from 'rapidworkers';
const rw = new RapidWorkers();
const quote = await rw.previewJobCost({ kind: 'ai_task', pay_rate: 0.25, quantity: 100 });
See each package's README for full examples.
Rules
At least $0.05 per worker ($0.10 for AI tasks, $0.50 per survey response), at least 10 workers per job, and a $20 minimum deposit. Creating a job needs a quote_id from preview_job_cost and confirm: true. Approving pays the worker and cannot be undone; pending submissions are approved automatically after 2 days.
How this repository works
spec/tools.jsonis the exact tool list of the hosted server.scripts/codegen.pygenerates each SDK's typed methods from it; CI fails if a generated file is stale.- The MCP packages are thin stdio relays: they forward every request unchanged to the hosted server, so they never fall behind it.
server.jsonis the MCP Registry entry.- Releases are published from GitHub Actions; see RELEASING.md.
License
MIT
RapidWorkers MCP questions
How do I add RapidWorkers MCP to Claude Code?
Run claude mcp add --env 'RAPIDWORKERS_API_KEY=<YOUR_RAPIDWORKERS_API_KEY>' rapidworkers -- npx -y rapidworkers-mcp in your terminal. Add --scope user to make it available in every project.
How do I add RapidWorkers MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does RapidWorkers MCP provide?
It exposes 22 tools, including get_account, get_platform_info, list_transactions, get_deposit_link, preview_job_cost.
What kind of tasks can I hire people for?
You can hire people for AI data collection (photos, audio, video, text), real-device app or website testing, and human judgment tasks like surveys or usability feedback.
What are the minimum requirements for creating a job?
Jobs require a minimum deposit of $20, at least 10 workers per job, and a minimum pay rate of $0.05 per worker (higher rates apply for specific task types).
How does the payment process work for submissions?
You review submissions to approve (pay) or reject them; however, pending submissions are automatically approved after 2 days.