# RapidWorkers MCP Server > MCP server that lets Claude, ChatGPT, Cursor or any AI agent hire real people for microtasks: preview the cost, post the task and approve each proof. Server URL: `https://www.rapidworkers.io/api/mcp/` (Streamable HTTP; sign in with OAuth 2.1 or send a RapidWorkers API key as a Bearer token). Web page: https://www.rapidworkers.io/mcp/ · Docs: https://www.rapidworkers.io/developers/#mcp · Full reference: https://www.rapidworkers.io/llms-full.txt ## Connect in 30 Seconds Pick your client and add the server URL. Clients with OAuth open a RapidWorkers sign-in; the others use an API key from your dashboard. ### Claude (web, desktop, mobile) Auth: OAuth (a RapidWorkers sign-in opens). 1. Open Claude, go to Customize, then Connectors, and choose Add custom connector. 2. Name it RapidWorkers and paste https://www.rapidworkers.io/api/mcp/ as the URL. 3. Click Connect and sign in with your RapidWorkers account to approve access. [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=RapidWorkers&connectorUrl=https%3A%2F%2Fwww.rapidworkers.io%2Fapi%2Fmcp%2F) ### ChatGPT Auth: OAuth (a RapidWorkers sign-in opens). 1. In ChatGPT, open Settings, then Apps (Plugins on some plans), and turn on Developer mode. 2. Add a custom MCP server with the URL https://www.rapidworkers.io/api/mcp/ and choose OAuth. 3. Sign in with your RapidWorkers account and approve access. ### Claude Code Auth: OAuth or API key. The --scope user flag makes RapidWorkers available in every folder. Without it, Claude Code only loads the server in the folder where you ran the command. Start a new Claude Code session afterwards. Sign in with OAuth (then run /mcp in Claude Code): ```bash claude mcp add --scope user --transport http rapidworkers https://www.rapidworkers.io/api/mcp/ ``` Or use an API key: ```bash claude mcp add --scope user --transport http rapidworkers https://www.rapidworkers.io/api/mcp/ \ --header "Authorization: Bearer YOUR_RAPIDWORKERS_API_KEY" ``` ### Cursor Auth: OAuth or API key. The Add to Cursor button signs you in with OAuth. The config file below uses an API key from an environment variable instead. [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=rapidworkers&config=eyJ1cmwiOiJodHRwczovL3d3dy5yYXBpZHdvcmtlcnMuaW8vYXBpL21jcC8ifQ%3D%3D) ~/.cursor/mcp.json: ```json { "mcpServers": { "rapidworkers": { "url": "https://www.rapidworkers.io/api/mcp/", "headers": { "Authorization": "Bearer ${env:RAPIDWORKERS_API_KEY}" } } } } ``` ### VS Code (GitHub Copilot) Auth: OAuth or API key. [Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22rapidworkers%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.rapidworkers.io%2Fapi%2Fmcp%2F%22%7D) .vscode/mcp.json: ```json { "inputs": [ { "type": "promptString", "id": "rapidworkers-key", "description": "RapidWorkers API key", "password": true } ], "servers": { "rapidworkers": { "type": "http", "url": "https://www.rapidworkers.io/api/mcp/", "headers": { "Authorization": "Bearer ${input:rapidworkers-key}" } } } } ``` ### OpenAI Codex Auth: OAuth or API key. Sign in with OAuth: ```bash codex mcp add rapidworkers --url https://www.rapidworkers.io/api/mcp/ codex mcp login rapidworkers ``` Or use an API key (~/.codex/config.toml): ```toml [mcp_servers.rapidworkers] url = "https://www.rapidworkers.io/api/mcp/" bearer_token_env_var = "RAPIDWORKERS_API_KEY" ``` ### Windsurf / Devin Auth: OAuth or API key. mcp_config.json: ```json { "mcpServers": { "rapidworkers": { "serverUrl": "https://www.rapidworkers.io/api/mcp/", "headers": { "Authorization": "Bearer ${RAPIDWORKERS_API_KEY}" } } } } ``` ### Gemini CLI Auth: OAuth or API key. Command: ```bash gemini mcp add --transport http rapidworkers https://www.rapidworkers.io/api/mcp/ \ --header "Authorization: Bearer YOUR_RAPIDWORKERS_API_KEY" ``` ### Goose Auth: OAuth (a RapidWorkers sign-in opens). The link opens Goose and adds the server. Sign in with your RapidWorkers account when Goose asks. [Add to Goose](goose://extension?url=https%3A%2F%2Fwww.rapidworkers.io%2Fapi%2Fmcp%2F&type=streamable_http&id=rapidworkers&name=RapidWorkers&description=Hire%20real%20people%20for%20microtasks) ### Any other MCP client Auth: OAuth or API key. 1. Point the client at https://www.rapidworkers.io/api/mcp/ using the Streamable HTTP transport. 2. Clients that support MCP OAuth sign in automatically; others send an API key in the Authorization header. Generic config: ```json { "mcpServers": { "rapidworkers": { "type": "http", "url": "https://www.rapidworkers.io/api/mcp/", "headers": { "Authorization": "Bearer YOUR_RAPIDWORKERS_API_KEY" } } } } ``` ## What Your Agent Can Do 22 tools cover the whole job: check the rules, price a task, post it and review every submission. ### Account & platform Balance, platform rules and deposit links. | Tool | What it does | OAuth scope | | --- | --- | --- | | `get_account` | Balance, deposit status, AI task access and commission rate. | `account:read` | | `get_platform_info` | Limits, fees, job categories, prefilled job types, AI task types, survey builder options and country codes. | Any connection | | `list_transactions` | The latest deposits, charges, refunds and payouts. | `account:read` | | `get_deposit_link` | A hosted card or crypto checkout link for a human to pay ($20 minimum). | `deposit:create` | ### Jobs, surveys & AI tasks Price, post, extend and cancel jobs, surveys and AI data tasks, optionally with an AI-generated image. | Tool | What it does | OAuth scope | | --- | --- | --- | | `preview_job_cost` | Exact cost (pay × workers + commission + pin) and a quote id, before anything is charged. | `jobs:read` | | `create_job` | Post a custom microtask for real people, with an optional AI-generated image; the cost is charged from the balance. | `jobs:write` | | `create_prefilled_job` | One-link jobs for common tasks such as likes, follows, shares or reviews. | `jobs:write` | | `create_survey` | Build a questionnaire that real people answer on RapidWorkers, with screening questions and quality checks; the cost is charged from the balance. | `jobs:write` | | `create_ai_task` | Collect photos, audio, video or text from real people for AI training, with an optional AI-generated example image. | `jobs:write` | | `request_ai_task_access` | Ask the RapidWorkers team to enable AI data tasks on the account. | `jobs:write` | | `list_jobs` | Your jobs, surveys or AI tasks with status, progress and pending submissions. | `jobs:read` | | `get_job` | Full details of one job, survey or AI task. | `jobs:read` | | `extend_job` | Add more worker slots to a job; the extra cost is charged from the balance. | `jobs:write` | | `cancel_job` | Stop a job and refund the unused budget (a $0.20 fee applies to live jobs). | `jobs:write` | ### Review & workers Check proof and survey results, pay workers and keep bad actors out. | Tool | What it does | OAuth scope | | --- | --- | --- | | `list_submissions` | Worker submissions with proof text, image links and worker stats, or survey responses with their answers and quality score. | `jobs:read` | | `get_survey_results` | Per-question counts, percentages, averages, NPS and text samples for a survey. | `jobs:read` | | `approve_submission` | Approve a submission and pay the worker, with an optional tip. | `submissions:review` | | `reject_submission` | Reject a submission with a reason the worker can see. | `submissions:review` | | `approve_all_pending` | Approve and pay every pending submission on a job at once, or only the survey responses with a good quality score. | `submissions:review` | | `block_worker` | Stop a worker from taking your jobs; their pending submissions are rejected. | `submissions:review` | | `unblock_worker` | Allow a blocked worker to take your jobs again. | `submissions:review` | | `list_blocked_workers` | Workers you have blocked. | `jobs:read` | Built-in prompts: - **Boost a social post** (`post_social_boost`): Pick a prefilled job type, preview the cost and post it. - **Review pending submissions** (`review_pending_submissions`): Check proofs against the brief and approve or reject each. - **Collect AI training data** (`collect_training_data`): Plan and post an AI data-collection task. Resources: - `rapidworkers://platform`: Platform rules and options - `rapidworkers://guide`: Agent quickstart ## From Prompt to Approved Work Your agent handles the API calls. You approve the spend and the results. 1. **Connect your client.** Add the server URL to Claude, ChatGPT, Cursor or any MCP client. Sign in with RapidWorkers or paste an API key. 2. **Describe the task.** Say what you need and from how many people. The agent checks the rules, shows the exact cost and waits for your OK. 3. **Review the proof.** Real people do the work and submit proof. The agent lists each submission so you can approve, tip or reject it. ## Same Prices and Rules as the Website Connecting is free. You pay for the tasks you post, and the server enforces the same minimums as the dashboard. - Minimum pay per task: **$0.05** - Minimum pay per AI data task: **$0.10** - Minimum pay per survey response: **$0.50** - Minimum workers per job: **10** - Minimum deposit: **$20** - A job costs pay per task × workers, plus the platform commission. Your rate is shown in the dashboard and in every cost preview. - A first deposit is required before posting. The agent can create a card or crypto checkout link for you to pay. - AI data tasks need access approved by the RapidWorkers team, and the agent can send the request. Surveys need no extra access, and people screened out of a survey are not paid. ## What a Task Looks Like in Chat The agent prices the task and posts it only after you confirm. Then it goes through the proof with you. **You:** Get 20 people to sign up on staging.example.com and report anything that breaks. Keep it under $5. **Agent:** _(calls `get_platform_info`, `preview_job_cost`)_ Here is the quote. Worker pay is $2.00 plus your commission, so it stays under $5 and your balance covers it. Shall I post it? - Workers: 20 × $0.10 - Worker pay: $2.00 - Commission: Your account rate - Quote valid for: 10 minutes **You:** Yes, post it. **Agent:** _(calls `create_job`)_ Posted. New jobs get a quick moderation check, then go live to workers. **You:** How are the submissions looking? **Agent:** _(calls `list_submissions`)_ 18 of 20 are in. 17 have the signup screenshot and a bug note; one screenshot is blank. Approve the 17 and reject the blank one? **You:** Do it. **Agent:** _(calls `reject_submission`, `approve_all_pending`)_ Done. 17 workers are paid, and the rejected worker sees the reason: "The screenshot is blank." _Example chat. Amounts and replies are illustrative._ ## What Agents Hire People For Anything a person can do in a few minutes and prove with a screenshot, a link or a short answer. ### Consensus votes on AI outputs Several people judge the same output, and the majority answer becomes your ground truth. Try: "Ask 15 people which of these two summaries is more accurate and give me the vote count." ### Data labeling People tag images, text or audio against your guidelines and submit their answers as proof. Try: "Have 30 people label the sentiment of these 20 reviews in the linked form." ### AI training data collection Collect photos, voice clips, video or text from people in the countries you choose, with an AI-generated example of what to submit. Try: "Collect 200 photos of handwritten receipts from people in India and Brazil." ### Surveys The agent builds the questionnaire on RapidWorkers: choice, rating, NPS, matrix and open questions, with screening questions and attention checks. Each response gets a quality score, and the agent reads back the results. Try: "Run a 10-question survey with 200 drivers in the US and the UK, then summarize the results." ### Usability tests People try a real flow on their own devices and report where they got stuck. Try: "Have 20 people sign up on our staging site and report every bug they hit." ### Social proof tasks Prefilled jobs turn one link into likes, follows, shares, retweets or reviews from real accounts. Try: "Get 100 real people to like our launch video on YouTube." ## You Stay in Control of Spending Access is scoped, revocable and tied to your account. New jobs need a fresh quote and your confirmation before anything is charged. - **Scoped OAuth access.** OAuth clients get only the scopes you approve on the RapidWorkers sign-in screen, and each tool checks its scope before it runs. - **Revocable keys.** Create and delete API keys in the dashboard, and disconnect OAuth clients there at any time. - **Confirm before spend.** New jobs, surveys and AI tasks need a quote from preview_job_cost (valid 10 minutes) and confirm=true after you approve the total. Adding workers, canceling and approving every pending submission also need confirm=true, and an idempotency key stops a retry from charging twice. - **Keys never in URLs.** Keys and tokens travel only in the Authorization header. Install links carry the server address and never a key. OAuth scopes (API keys have full account access): - `account:read`: Read your balance, transactions and account status - `jobs:read`: Read your jobs, surveys, AI tasks and their submissions - `jobs:write`: Create, extend and cancel jobs, surveys and AI tasks (spends balance) - `submissions:review`: Approve or reject submissions and block workers (pays workers) - `deposit:create`: Create deposit checkout links for you to pay ## Call It from Your Own Agent The same server works from code. The API & MCP docs have a ready-to-run example for each of these. - **Claude API.** Pass the server URL and an API key in mcp_servers, and Claude calls the tools during the request. - **OpenAI Responses API.** Add the server as an mcp tool with your API key in the Authorization header. - **MCP Inspector.** List and call the tools from your terminal before you wire up an agent. Code examples: [API & MCP docs](https://www.rapidworkers.io/developers/#mcp) ## FAQ ### What is the RapidWorkers MCP server? It is a remote MCP server at https://www.rapidworkers.io/api/mcp/ that lets AI assistants and agents hire real people on RapidWorkers. Your agent can check the rules, price a task, post it, and review and pay for submissions from the chat or from code. It can also add an image generated with AI, at no extra cost, to show workers what to do. ### Which AI clients can connect to it? Any client that supports remote MCP servers over Streamable HTTP. Claude (web, desktop and mobile), ChatGPT, Claude Code, Cursor, VS Code with GitHub Copilot, OpenAI Codex, Windsurf, Gemini CLI and Goose all work, as do agents built on the Claude API, the OpenAI Responses API or an MCP SDK. ### How much does the MCP server cost? Connecting is free and there is no subscription. You pay only for the tasks you post: pay per task × number of workers, plus the platform commission shown in your dashboard. The agent shows the exact total with preview_job_cost before anything is charged. ### Should I connect with OAuth or an API key? Use OAuth when your client supports it. Claude and ChatGPT sign in this way, and you approve exactly which permissions the client gets. Use an API key for scripts, autonomous agents and clients that can only send a header. A key has full access to your account, so keep it in an environment variable. ### What are the minimums for posting a task? Pay must be at least $0.05 per task ($0.10 for AI data tasks and $0.50 per survey response), every job needs at least 10 workers, and deposits start at $20. A first deposit is required before posting. The server rejects anything below these limits with a message that says how to fix it. ### How does proof of work work? Each worker submits the proof your brief asks for, such as a screenshot, a link or a short answer. The agent lists submissions with the proof text, image links and the worker's approval rate, then approves and pays, tips, or rejects with a reason the worker can see. Submissions you don't review are approved automatically after 2 days. ### Is it safe to let an AI agent spend my balance? Spending is gated. New jobs need a fresh quote and your explicit confirmation, and adding workers, canceling or approving every pending submission needs confirmation too. Paid calls take an idempotency key, so retrying with the same key never charges twice. OAuth connections get only the scopes you approve, and you can delete keys or disconnect clients from the dashboard at any time. ## Put Real People Behind Your Agent Create a free account, make your first deposit and connect the MCP server from Claude, ChatGPT, Cursor or your own code. - [Create a free account](https://www.rapidworkers.io/auth/jwt/register/) - [Get an API key](https://www.rapidworkers.io/auth/jwt/login/?returnTo=%2Fdashboard%2Fapi-management%2F) - [API & MCP docs](https://www.rapidworkers.io/developers/#mcp)