Write actions
Write tools are listed only for tokens created with Read and write access (owner:workspace:write). They call the same services as the owner website, so every rule you see in the UI applies here too.
Writes are not idempotent
Write tools don't take an idempotency key. If a response is uncertain, read the affected resource before retrying. Repeating a create or a comment can create a second record.
Amounts are integer minor units: santim for ETB and cents for USD. Read the campaign's currency first.
Reports
comment_report
Posts a reply that the tester can see.
| Argument | Type | Notes |
|---|---|---|
reportId | UUID | |
body | string | 10 to 10,000 characters |
attachmentIds | UUID[] | Optional. Up to 5 of your uploads that are ready. Upload through the website first. |
decide_report
Makes or reverses a review decision.
| Argument | Type | Notes |
|---|---|---|
reportId | UUID | |
action | approve | reject | duplicate | request_information | reverse | |
reason | string | 10 to 4,000 characters. Required for every action. |
duplicateOf | UUID | Required for duplicate. Must be in the same campaign. |
bountyType | standard | critical | special | Optional reward tier for approval |
decisionVersion | integer | Required for reverse. Take it from get_report. |
Approval pays the tester
Approving a paid report releases its reserved reward. Settlement happens exactly once, even if you retry.
- Always call
get_reportbefore deciding. reverseworks only within one hour of the decision and needs the currentdecisionVersion.- Review deadlines, appeal rules, and Premium conversation restrictions still apply.
Apps
create_app
| Argument | Type | Notes |
|---|---|---|
name | string | 2 to 100 characters |
platform | web | android | ios | |
url | string | HTTP or HTTPS |
description | string | 10 to 2,000 characters |
brandingId | UUID | Optional |
delete_app
| Argument | Type |
|---|---|
appId | UUID |
Deletes an app only if it has no remaining campaigns and no Play Store history.
Campaign management
create_campaign
Creates an unfunded draft. Fund it from the website before activating it.
| Argument | Type | Notes |
|---|---|---|
appId | UUID | |
title | string | 5 to 140 characters |
summary | string | Public. 20 to 500 characters. |
scope | string | What to test. 20 to 10,000 characters. |
instructions | string | Private. 20 to 10,000 characters. |
bountyMinor | integer | Base (standard) reward |
budgetMinor | integer | Must cover every enabled reward |
endsAt | ISO datetime | Include an explicit timezone |
currency | ETB | USD | Defaults to ETB |
visibility | public | private | Defaults to public. Private requires Premium. |
bountyRewards | { standard, critical?, special? } | Optional. standard must equal bountyMinor. |
update_campaign
Pass campaignId and at least one of title, summary, scope, or instructions.
update_campaign_rewards
| Argument | Type |
|---|---|
campaignId | UUID |
bountyRewards | { standard, critical?, special? } |
Changes rewards for future reports only. Existing reports keep the amounts they were submitted with.
extend_campaign
| Argument | Type | Notes |
|---|---|---|
campaignId | UUID | |
endsAt | ISO datetime | Must be later than the current deadline and in the future |
change_campaign_status
| Argument | Type |
|---|---|
campaignId | UUID |
status | draft | active | paused | closing |
Only allowed lifecycle transitions succeed. Activating a campaign still requires funding, and this tool cannot fund one.
delete_campaign
| Argument | Type |
|---|---|
campaignId | UUID |
Deletes an unfunded draft that has no pending payments.
Not available over MCP
- Payments: checkout, funding, and withdrawals
- File uploads (use the website, then pass
attachmentIds) - Play Store management
- Tester and administrator actions
Comment, decide on reports, and manage apps and campaigns from your agent.