Microworkers MCP Server

Create a new Basic Campaign (API: POST /basic-campaigns) on Microworkers. Workers will see it and can accept the task. You need: a template_id (create...

Create a campaign targeting a specific hire group of workers.

Add a new tasks group to a campaign with unique task details. Each task group contains one or more tasks that a worker completes together.

Create a reusable task template with HTML instructions and form fields. Microworkers auto-detects standard HTML form elements (input, textarea, select...

Delete a stopped campaign. The campaign must be stopped first. This permanently removes it from your account.

Delete a stopped hire group campaign.

Delete all untaken slots from a tasks group. Only removes slots with UNTAKEN status.

Delete a custom template. Cannot delete templates that are in use by active campaigns.

Get the download URL for a worker's file proof. The URL requires authentication with the API key header.

Exclude a worker from all your future campaigns. Use for workers who submit low-quality or spam work. To undo, remove the worker from the exclusion li...

Get your Microworkers account ID and balance. The balance shows how much money is available to fund campaigns. Deposit funds at https://www.microworke...

Get full details of a Basic Campaign (API: /basic-campaigns/{id}) including status, slots_count breakdown (ok/nok/not_rated/locked/untaken), blocked_r...

Get a single category by ID.

Get details of a hire group campaign.

Check the status of an async job. Some operations (like campaign restart, adding task groups) return a job ID. Use this to see if the job completed su...

Get full details of a slot including the worker's answers, status, country, and file proofs. A slot is a single worker's submission for a campaign pos...

Get details of a specific task within a campaign. Tasks hold unique data assigned to individual worker positions.

Get details of a specific tasks group.

Get full details of a template including HTML content, questions, and variables.

Get details of a specific transaction.

Get information about a Microworkers worker by their ID.

Give a bonus to a worker for a completed slot. The bonus must be between 10% and 200% of the position cost. Can only be given to slots rated as OK (Sa...

List your Microworkers Basic Campaigns (API: /basic-campaigns) with status, position counts, and payment info. Basic Campaigns are the standard campai...

List slots (worker submissions) for a campaign. Filter by status to find submissions awaiting review (status='NOTRATED') or completed work (status='OK...

List all available campaign categories on Microworkers. Each category has an ID and title. Key categories: '05' = Offer/Sign up (for account registrat...

List your custom hire groups.

List default (built-in) hire groups. Each group has an ID, title, and worker count. Use the group ID when creating hire group campaigns.

List built-in default templates. These can be used as starting points or directly when creating campaigns.

List workers you have excluded from your campaigns. If the response includes a next_page_token, pass it in a follow-up call to get the next page.

List all available geo zones for campaign targeting. Use the zone ID when creating campaigns. Key zones: 'int' = International (all countries).

List slots for a hire group campaign.

List your hire group campaigns.

List sub-categories for a given category, including minimum payment per task for each geo zone. Use the sub-category ID (categoryId) when creating cam...

List all tasks groups in a campaign.

List all slots for a specific tasks group.

List all tasks in a campaign. Tasks contain unique data (key/value pairs) assigned to individual worker positions.

List all slots for a specific task within a campaign. Shows worker answers and submission status for that task.

List your custom task templates. Templates define the form workers fill out. Use the template ID when creating campaigns. If the response includes a n...

List your Microworkers account transactions including deposits, campaign charges, and withdrawals. Filter by type to see specific transaction categori...

Pause an active campaign. Workers currently working can finish, but no new workers can accept tasks. Resume the campaign to reactivate.

Pause a hire group campaign.

Rate a worker's submitted task. 'OK' approves and pays the worker, 'NOK' rejects (no payment, must include reason), 'REVISE' sends it back for the wor...

Remove a worker from your exclusion list so they can work on your campaigns again.

Restart a finished or stopped campaign with additional positions. Minimum 30 positions.

Resume a paused campaign so new workers can accept tasks again.

Resume a paused hire group campaign.

Stop a campaign permanently. Unfinished positions are refunded. This cannot be undone — pause the campaign instead if you want to temporarily halt.

Stop a hire group campaign permanently.

Update campaign settings like speed, TTR, qualification requirements, and auto-refill.

Update question settings on a campaign — make answers required, enforce unique answers across the campaign or per question.

Update a tasks group — change the number of available positions.

Update an existing template's HTML, title, or scripts.

Update question settings on a template — make answers required or enforce unique answers.