Interpreted tools
These tools accept GraphQL variable names and return the selected operation data as JSON. The operation files and kontrol schema own the generated reference below.
accept_journey_draft
Section titled “accept_journey_draft”Accept a draft journey after reviewing it. The draft becomes a journey that audits can run, counted against the journey limit. Edit it afterwards with update_journey. Refused for a draft that is already accepted.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
accept_organization_invite
Section titled “accept_organization_invite”Accept a pending organization invitation as its email recipient and return the membership and invitation. Seat capacity and invitation validity are checked by the organization service.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | AcceptOrganizationInviteInput! | yes |
allow_project_repository
Section titled “allow_project_repository”Allow binclusive[bot] to comment on a GitHub repository for this project. The repository must be in the organization’s GitHub App installation. Members only; a CI token is refused. Allow binclusive[bot] to comment on a GitHub repository for a project. The repository must be in the organization’s GitHub App installation; kontrol’s refusal says what to fix when it is not.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
repo | String! | yes | The repository as owner/name, its GitHub URL, or its SSH remote. |
approve_glyph_alt
Section titled “approve_glyph_alt”Approve one glyph description as an organization member and return the reviewed description. Owner refusals are GraphQL errors.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | ApproveGlyphAltInput! | yes |
archive_target
Section titled “archive_target”Remove a web target or retire a build target as an organization admin or owner. Returns the affected target or a refusal; retired builds remain available to existing runs.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | ArchiveTargetInput! | yes |
assign_agentic_ticket
Section titled “assign_agentic_ticket”Assign an agentic violation ticket to a user (or unassign by omitting assigneeId)
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes | |
assigneeId | String | no |
auth_capture_context
Section titled “auth_capture_context”Select a persona and live web deployment for a local browser login capture.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
persona | String! | yes | |
target | String! | yes |
ban_user
Section titled “ban_user”Ban a user with platform:users:write authority and a reason. Refuses self-bans, users with platform capabilities, missing users and already banned users.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | BanUserInput! | yes |
browser_availability
Section titled “browser_availability”Read browser-session limits and current availability as an authenticated user.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
cancel_audit
Section titled “cancel_audit”Cancel an accessibility audit. A queued request and every run in it are cancelled before dispatch. A dispatched or local run records a stop request that the executor honours at its next contact. Refuses callers outside the run’s organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
runId | String! | yes |
cancel_cloud_qa_audit
Section titled “cancel_cloud_qa_audit”Cancel a cloud QA request by its cloud run request ID. A queued request is removed from the queue. For a dispatched request, active runs end and VM teardown is attempted; teardown failure is reported but does not change the cancelled outcome. A request that already ended is left unchanged.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
cloudRunRequestId | String! | yes |
change_billing_plan
Section titled “change_billing_plan”Request a billing plan change as the organization owner. Returns the outcome, request, portal URL or refusal; a portal URL requires the customer to continue at the provider.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
planVersionId | ID! | yes | |
cadence | ANNUAL | MONTHLY! | yes | |
decisionKey | String! | yes | Opaque precondition from usageAndLimits.purchase. Missing or changed previews are refused before sending to the provider. |
check_organization_slug
Section titled “check_organization_slug”Returns true if the slug is available, false if it is already taken.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
slug | String! | yes |
cloud_runner_context
Section titled “cloud_runner_context”The spawn record the calling cloud-runner VM was provisioned under. Reachable only by one of our own runner VMs, presenting a GCE instance-identity token.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
includeQa | Boolean! | no | Included when true. |
configure_project_audit_schedule
Section titled “configure_project_audit_schedule”Set or disable the project’s recurring audit schedule as an organization administrator.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
schedule | daily | monthly | weekly | no |
configure_project_languages
Section titled “configure_project_languages”Enable or disable the project’s audit languages as an organization administrator.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
disable | [String!] | no | |
enable | [String!] | no | |
projectId | ID! | yes |
configure_project_sitemap
Section titled “configure_project_sitemap”Replace a web project’s sitemap URL, schedule and enabled setting as an organization administrator.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
sitemap | SitemapConfigInput! | yes |
configure_project_ticket_language
Section titled “configure_project_ticket_language”Choose the project’s ticket language as an organization administrator.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
ticketLanguage | String | no |
configure_project_widget
Section titled “configure_project_widget”Update the project’s widget settings as an organization administrator within its entitlements.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
widget | WidgetConfigurationInput! | yes |
create_journey
Section titled “create_journey”Create a new test journey for a project. Journeys define user flows to test during audits. Pass personaId to have the journey sign in as that persona; a persona from another project, or one on a mobile app’s journey, is refused.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
description | String | no | |
entry | JSON | no | |
name | String! | yes | |
personaId | String | no | |
projectId | ID! | yes | |
steps | [String!] | no |
create_journey_drafts
Section titled “create_journey_drafts”Draft one journey per section of a page audit’s coverage plan at the given capture revision, with the section’s steps in order. Drafts never run: a person reviews each one and accepts it with accept_journey_draft. Drafting the same revision again returns the drafts it already has; once that revision’s plan has changed, drafting it again is refused, so run a new page audit instead. Also refused until that revision’s plan step has completed, when its plan is out of date, and when the page audit flag is off for the organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
pageAuditId | ID! | yes | |
projectId | ID! | yes | |
revision | Int! | yes | The capture revision whose coverage plan is drafted: the revision in get_page_audit’s report, or the revision the dashboard shows after interacting with the page. |
create_journey_group
Section titled “create_journey_group”Create a journey group for a project. Groups bundle related journeys so they can be audited together. Add journeys to it afterwards.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
description | String | no | |
name | String! | yes | |
projectId | ID! | yes |
create_organization
Section titled “create_organization”Create a new organization with you as its owner. If the requested slug is taken, tries numbered variants before failing.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
name | String! | yes | |
slug | String! | yes |
create_page
Section titled “create_page”Import tracked pages within the project page allowance.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | a raw prj_… id or a base64 Project global id |
urls | [String!]! | yes |
create_page_audit_tickets
Section titled “create_page_audit_tickets”Turn a finished page audit’s definite violations, at the given capture revision, into tickets in the project. Refused when the project belongs to another organization than the page audit, when that revision’s audit has not finished or is out of date, or when the page audit flag is off.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
pageAuditId | ID! | yes | |
projectId | ID! | yes | |
revision | Int! | yes | The capture revision whose audit is filed: the revision in get_page_audit’s report, or the revision the dashboard shows after interacting with the page. |
create_persona
Section titled “create_persona”Create a named test account persona in a project.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
name | String! | yes | |
projectId | ID! | yes | |
testAccountAcknowledged | Boolean! | yes | Must be true. The caller confirms this persona logs in as a dedicated test account, not a real person’s. |
create_project
Section titled “create_project”Create a project and its starter journey as an organization member within its project allowance.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
bundleId | String | no | |
description | String | no | |
domain | String | no | |
egressCountry | tr | us | no | |
name | String! | yes | |
organizationId | ID! | yes | a raw Organization id or a base64 Organization global id |
type | android | ios | web! | yes | |
useCases | [altText | ci | usability!]! | yes |
create_project_page
Section titled “create_project_page”Add a tracked page as an organization member.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | CreateProjectPageInput! | yes |
create_qa_journey_group
Section titled “create_qa_journey_group”Create a QA journey group for a project, optionally with its initial journeyIds. Groups bundle related QA journeys so they can be run together. Every member must belong to the project. Replace membership later with set_qa_journey_group_members.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
description | String | no | |
journeyIds | [String!] | no | |
name | String! | yes | |
projectId | ID! | yes |
create_target
Section titled “create_target”Create a named web target with a base URL and environment as an organization admin or owner. Returns the target or a refusal.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | CreateTargetInput! | yes |
create_ticket
Section titled “create_ticket”File an authored accessibility finding and its ticket. The entrypoint names where the claim is filed. The project decides its organization, so no organization is needed.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
criterion | String | no | |
description | String! | yes | |
element | String! | yes | |
evidence | String! | yes | |
impact | critical | minor | moderate | serious | unknown! | yes | |
location | AuthoredLocationInput! | yes | |
projectId | String! | yes | |
recommendation | String! | yes |
delete_agentic_ticket
Section titled “delete_agentic_ticket”Delete a ticket that is pure test-device noise, so it leaves every list and count. Org Admins and Owners; every finding on it is hidden, not destroyed, and a later sighting that joins the ticket brings it back.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
delete_journey
Section titled “delete_journey”Delete an accessibility journey by its ID. Requires membership in its owning organization. Refused when the journey has audit history.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
delete_journey_group
Section titled “delete_journey_group”Delete a journey group. The member journeys themselves are not deleted, only the grouping.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
delete_page
Section titled “delete_page”Delete tracked pages as their organization administrator.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
ids | [ID!]! | yes |
delete_persona
Section titled “delete_persona”Delete a persona by its ID. Requires an organization admin or owner. While accessibility or QA journeys still use it, returns AuthPersonaInUse with journeyCount instead of deleting it. Point those journeys elsewhere first.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
delete_project
Section titled “delete_project”Delete a project. Requires an organization admin or owner. Refused when the project has audit history.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes |
delete_project_page
Section titled “delete_project_page”Delete a tracked page as an organization administrator.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes | a raw prjpg_… id or a base64 ProjectPage global id |
delete_qa_journey
Section titled “delete_qa_journey”Delete an Agentic QA journey by id or exact name. Its past runs are kept.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
journey | String! | yes | |
projectId | ID | no |
delete_qa_journey_group
Section titled “delete_qa_journey_group”Delete a QA journey group. The member QA journeys themselves are not deleted, only the grouping.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
groupId | String! | yes |
describe_glyph_page
Section titled “describe_glyph_page”Start descriptions for a page’s describable glyphs in the given languages. Returns the workflow ID, reusing an in-progress request with the same selection and languages. A different request already running, no describable glyphs, no languages or a billing refusal is refused with a GraphQL error carrying the owner refusal. Read resulting alt text later with list_page_glyphs.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
languages | [String!]! | yes | |
pageId | ID! | yes |
dismiss_project_setup_band
Section titled “dismiss_project_setup_band”Dismiss a project’s setup band as an organization member and return the project.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | DismissProjectSetupBandInput! | yes |
edit_glyph_alt
Section titled “edit_glyph_alt”Save a glyph’s description in one language as an organization member, creating that language’s description when absent. Owner refusals are GraphQL errors.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | EditGlyphAltInput! | yes |
export_evidence
Section titled “export_evidence”Generate a project’s evidence export, the same XLSX workbook or HTML document the dashboard downloads, and return it base64-encoded. Each export writes an audit-log entry.
Returns MCP content according to its GraphQL result type. Image results include a resource link; file results include an embedded resource and digest metadata. Null results and refusals remain GraphQL JSON data. GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | GenerateEvidenceExportInput! | yes |
Evaluate a set of feature flags. Targeting context is built server-side from the session and optional route-scoped organization; returns resolved booleans only.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
keys | [FlagInput!]! | yes | |
organizationId | ID | no | Optional route-scoped organization. When supplied, the caller must be a member and org/role targeting is evaluated against this org. |
font_url_probe
Section titled “font_url_probe”Fetches a font URL from our side and says whether it answered, so the dashboard can report a broken font at config time rather than leaving the widget to fail silently.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
fontUrl | String! | yes | |
organizationId | ID! | yes |
get_agentic_audit_report
Section titled “get_agentic_audit_report”A run’s accessibility audit report: its findings with the classification each settled, deduplicated tickets, the agent’s output and notes, and recording availability. The status is running while the run is going, then completed or error. A run past its 30-day retention keeps its findings and tickets but reports no agent output or notes. All collections are Relay connections; follow their endCursor while hasNextPage is true. Refused outside the run’s organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
includeTickets | Boolean | no | Include deduplicated tickets. Requires organization membership; false returns the report without tickets, as its runner may read it. |
includeDetails | Boolean | no | Included when true. |
runId | String! | yes | a raw run_… id or a base64 AgenticRun global id |
first | Int | no | |
ticketsAfter | String | no | |
findingsAfter | String | no | |
resultsAfter | String | no | |
notesAfter | String | no |
get_agentic_run_trace
Section titled “get_agentic_run_trace”Tool round trips and step results in time order as JSONL, with screenshot digests. Available during and after a run. Refused outside the run’s organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
runId | ID! | yes | a raw run_… id or a base64 AgenticRun global id |
get_agentic_ticket
Section titled “get_agentic_ticket”Get full details of a single agentic violation ticket
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
get_audit_progress
Section titled “get_audit_progress”Get an accessibility audit by its run ID, or null when no run exists. A cloud run is queued while waiting for a slot or booting; queuePosition is its place in line while waiting for a slot, otherwise null. Status may be running, completed, failed or interrupted. violations is the stored violation count reported for the run and may be null. The same run ID is accepted by get_agentic_audit_report and cancel_audit.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
runId | String! | yes |
get_journey_audit
Section titled “get_journey_audit”Read a journey audit by its id, including frozen members, progress, terminal owner messages and when to poll again.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes |
get_organization
Section titled “get_organization”Get organization details by slug, including members
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
slug | String! | yes |
get_organization_billing
Section titled “get_organization_billing”Get an organization’s independently readable billing panels. The nullable account panel contains lifecycle and a nullable subscription. The nullable usage panel contains current usage meters with entitlementKey, limit, consumed, reserved, available, periodStart and resetAt. An unreadable panel returns null with a field error while readable siblings remain available; a readable usage panel with no current periods has an empty meters array. Read usage after a quota refusal to find the exhausted allowance and its reset time.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes |
get_page_audit
Section titled “get_page_audit”Read a page audit started with startPageAudit. The report carries step status and failure reasons, the summary counts and every definite violation, with the totalCount of its needs-review, resolved, not-tested and coverage plan groups. Each finding names its source: a code check measured the evidence, and a jev check carries violationProbability, how likely Jev judged it a violation. In a new audit a Jev check is a violation at its rule’s cut-off or more (the report’s thresholds.violation) and never waits for review, and a reviewer can still overturn it; an audit saved before can still list Jev checks under needs-review. Read those groups’ items with pageAuditItems (MCP list_page_audit_items, CLI b8e list page-audit-items). needsReview items are not defects: do not auto-fix them or file them as tickets without confirmation. Poll until report.status is finished. Refused when the page audit flag is off for the organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes |
get_project
Section titled “get_project”Read an object by its GraphQL global ID, including project details for a Project ID.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
get_project_glyph_summary
Section titled “get_project_glyph_summary”Aggregate glyph state for this project in one language.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
language | String! | yes |
get_project_widget_settings
Section titled “get_project_widget_settings”The project’s typed configuration.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
get_qa_finding
Section titled “get_qa_finding”Get a QA Finding by ID, or null when it does not exist or the caller is outside its run’s organization. Includes runId, journeyName, locale, stepIndex, severity, instruction, location, screenshotUrl and detail. Assertion detail contains expectedResult, observed and reasoning; crash detail contains exceptionLine and crashExcerpt. ticket contains the current QA ticket status. Its closedByRunId identifies the run that closed the ticket, or is null when no run closed it. Automatic closure requires two consecutive runs in one environment that clear the ticket’s step: a passing assertion, or execution past the crash. Other steps need not pass.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes |
get_qa_journey
Section titled “get_qa_journey”One of the project’s saved QA journeys, or null when the project has none with that id or the caller is outside the project’s organization. Get one Agentic QA journey by its QA journey ID: its name, locale, persona (or null for a public journey), startPath and viewport for a web journey or entry for an app journey, and every step in order with its instruction and expectedResult (null for a step that is performed but not judged).
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
journeyId | String! | yes |
get_qa_run_result
Section titled “get_qa_run_result”A QA run by id, with its owner-computed verdict and joinedSteps, including pending steps. Null when it does not exist or belongs to another organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
runId | String! | yes | a raw qar_… id or a base64 QaAuditRun global id |
get_viewer
Section titled “get_viewer”Get the current viewer and user, including the user’s organization memberships. Returns null when no user is authenticated.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
first | Int | no | |
after | String | no |
get_violation_screenshot
Section titled “get_violation_screenshot”Get a violation screenshot as base64 image bytes, its MIME type, name and resource URL. Returns null when unavailable or outside the caller’s organization.
Returns MCP content according to its GraphQL result type. Image results include a resource link; file results include an embedded resource and digest metadata. Null results and refusals remain GraphQL JSON data. GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
key | String! | yes |
grant_organization_entitlement_override
Section titled “grant_organization_entitlement_override”Grant a timed organization entitlement override with a reason, requiring platform:billing:override. Returns the override, affected organization, warnings or refusal.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
entitlementKey | String! | yes | |
value | String! | yes | |
expiresAt | String! | yes | |
reason | String! | yes | |
operation | ADD | DISABLE | ENABLE | REPLACE! | no | |
scope | ORGANIZATION | PLATFORM_EMERGENCY! | no | |
startsAt | String | no | |
ticket | String | no | The issue this grant answers. Free-text today, so the audit trail carries a pointer rather than only a sentence. |
grant_platform_billing_capability
Section titled “grant_platform_billing_capability”Grant a platform capability to another existing user with platform:billing:override authority and a reason. Returns the platform principal; self-grants are refused.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | GrantPlatformBillingCapabilityInput! | yes |
hide_agentic_finding
Section titled “hide_agentic_finding”Hide one finding (an occurrence of a ticket) that came from test-device noise, so it leaves every list and count. Org Admins and Owners; the finding is kept, not deleted.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
findingId | String! | yes |
import_qa_journeys
Section titled “import_qa_journeys”Import Agentic QA journeys in the file shape b8e qa journeys import reads. A matching sourceKey updates an existing journey; otherwise a new journey is created. For a new import, personaId sets the persona on every imported journey. Omitting it creates public journeys and preserves existing personas on source-key updates. A repeated requestKey returns the first import’s saved journeys instead of applying changes. Returns the imported journeys, including their IDs and names. Validation, platform, site, persona and quota refusals save no journeys. Use update_qa_journey to edit by ID, or set_qa_journey_persona to change only the persona.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
journeys | JSON! | yes | The journey file: a list of journeys as @b8e/qa-contract defines them. |
personaId | String | no | The persona every journey in the file runs as. Omitting it imports public journeys, and keeps the persona of a journey a source key re-imports. |
projectId | ID! | yes | |
requestKey | String | no | Identifies one import request. Re-sending the same key to the same project returns the journeys the first request created instead of creating them again. |
import_sitemap
Section titled “import_sitemap”Start a sitemap crawl to import pages into a web project. The accepted crawl identifies the workflow that Auditer started.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
sitemapUrl | String! | yes |
invite_organization_member
Section titled “invite_organization_member”Invite a person to an organization by email (requires admin role; refused when every seat is taken)
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
email | String! | yes | |
organizationId | ID! | yes | |
role | admin | member! | yes |
leave_organization
Section titled “leave_organization”Leave an organization you belong to. The last owner cannot leave. Returns organizationId on success or an error with code and message on refusal.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes |
list_agentic_tickets
Section titled “list_agentic_tickets”List agentic violation tickets for an organization with optional filters and forward pagination. Default page size 20, maximum 100. Production only, ordered by needs attention unless specified. IDs use GraphQL global IDs.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
status | BACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX | no | |
platform | android | ios | react_native | unity | unknown | web | no | |
priority | P0 | P1 | P2 | P3 | no | |
first | Int | no | |
after | String | no |
list_deployments
Section titled “list_deployments”List a project’s live web deployments with their ID, name, environment, base URL and creation time. Retired deployments are excluded; ask retiredTargets for them. Mobile builds are in buildTargets. Capture a persona login on a web deployment with b8e profile create —persona
The deployments an operator has taken out of circulation, newest facts first read through archivedAt. They still answer for the runs that already point at them: a run’s target is resolved without regard to retirement.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
includeRetired | Boolean! | no | Included when true. |
list_journey_drafts
Section titled “list_journey_drafts”List a project’s draft journeys, newest page audit first. A pending draft never runs until a person accepts it with accept_journey_draft.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_journey_groups
Section titled “list_journey_groups”List journey groups for a project, each with its member journeys and journey count. Use group IDs with set_journey_group_members or run_journey_group.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_journeys
Section titled “list_journeys”List saved journeys for a project. Each journey carries its persona, the ID and name of the test account it signs in as, or null for a public journey. Use journey IDs when starting an audit.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_organization_audit_log
Section titled “list_organization_audit_log”List an organization’s audit log, newest first. Each entry exposes its id, mutation, projectId, createdAt, session, input, before and after. Read the actor through session.user. Pages with first/after; pass pageInfo.endCursor as after to load more. A plan without the audit log is refused with kontrol’s message.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
first | Int | no | |
after | String | no |
list_organization_invites
Section titled “list_organization_invites”List an organization’s invitations with each one’s email, inviter, role, status and expiry
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
first | Int | no | |
after | String | no |
list_organizations
Section titled “list_organizations”Get the current viewer and user, including the user’s organization memberships. Returns null when no user is authenticated.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
first | Int | no | |
after | String | no |
list_page_audit_items
Section titled “list_page_audit_items”Read one group of a page audit’s items a page at a time: the needs-review items, the resolved items, the not-tested checks or the coverage plan steps. The page audit report (pageAudit, MCP get_page_audit) gives each group’s totalCount. Each check item names its checkId and its source; a jev item carries violationProbability, and needs-review items come most likely violation first, then code checks. The cursor names the last item read, so an item a reviewer answers between two pages moves group without shifting the rest. Pages hold at most 50 items. Follow pageInfo.endCursor as after while hasNextPage is true. A cursor from an earlier analysis of the page is refused: read the group again from its first page. needsReview items are not defects: do not auto-fix them or file them as tickets without confirmation. Null for a page audit that does not exist. Refused when the page audit flag is off for the organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes | |
group | coveragePlan | needsReview | notTested | resolved! | yes | |
first | Int | no | |
after | String | no |
list_page_glyphs
Section titled “list_page_glyphs”Glyphs linked to this page, with per-language occurrence status on each edge.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
pageId | ID! | yes | |
language | String! | yes | |
filter | NEEDS_ATTENTION | REJECTED | no | |
types | [audio | button | iframe | img | input | link | other | video!] | no | |
intent | decorative | describe | excluded | no | Reviewer intent for the glyph. describe = needs alt text; decorative = intentionally empty; excluded = out of scope. |
first | Int | no | |
after | String | no |
list_pages
Section titled “list_pages”Every page belonging to this project, language-agnostic. Used by page management, the sidebar count, and sitemap diff — none of which carry a review lens. For the glyph description work queue (language-scoped, type-scoped) use glyphWorkItems.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
first | Int | no | |
after | String | no | |
search | String | no | Case-insensitive URL substring filter. |
list_personas
Section titled “list_personas”List the project’s test account personas and their captured sessions per deployment. Capture login with b8e profile create —persona
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_pr_findings
Section titled “list_pr_findings”The latest b8e ci scan run uploaded for this pull request, or null when none was. List the accessibility findings of the latest b8e ci run uploaded for one pull request of a project, the same list the dashboard’s pull request page shows. Each has its id, fingerprint, location (a source path and line, or a page url), rule, criterion, element, evidence, description, recommendation, impact, change and seenAt. change is new when the previous run on the pull request’s branch did not have that fingerprint, and carried_over when it did. Pages with first/after; pass pageInfo.endCursor as after to load more. totalCount counts every finding of the run. When no run was uploaded for the pull request, prScanRun is null and there is no findings count. These findings are not tickets.
The run’s findings, file by file: source files first, then pages, each in upload order.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
repo | String! | yes | |
prNumber | Int! | yes | |
first | Int | no | |
after | String | no |
list_project_agentic_tickets
Section titled “list_project_agentic_tickets”List violation tickets in this project
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
status | BACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX | no | |
platform | android | ios | react_native | unity | unknown | web | no | |
priority | P0 | P1 | P2 | P3 | no | |
first | Int | no | |
after | String | no |
list_project_ci_repositories
Section titled “list_project_ci_repositories”The GitHub repositories permitted for this project.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_project_ci_tokens
Section titled “list_project_ci_tokens”List the project’s CI tokens, including their ID, name, masked start, enabled and expiry state, expiry time, remaining days, last request, creation time and creator email. Ordering is unspecified. Visible to organization members; the plaintext secret is shown only at creation. Each token can submit findings only for its project.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_project_run_history
Section titled “list_project_run_history”List a project’s AgenticRun audits, including local and cloud runs, and uploaded CliScan static scans. Failed and interrupted audits are hidden by default; includeUnfinished includes them. Each entry identifies its kind in __typename. Pass a CliScan ID to list_scan_run_findings to read its findings.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
first | Int! | yes | |
after | String | no | |
search | String | no | Literal case-insensitive journey name search. A nonempty search omits CLI scans, which have no journey. |
runningOnly | Boolean | no | Only queued or running audits. |
includeUnfinished | Boolean | no | Include runs that stopped without producing a report (failed, interrupted). Off by default. Status filtering never hides CLI scans. A scan receipt has no status. |
list_project_tickets
Section titled “list_project_tickets”List violation tickets in this project
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
first | Int | no | |
after | String | no |
list_projects
Section titled “list_projects”List projects in an organization
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
first | Int | no | |
after | String | no |
list_qa_findings
Section titled “list_qa_findings”The project’s QA Findings, newest first, under the organization that owns the project, narrowed by any of journey, step, severity and QA ticket status. Null for a caller outside it. List a project’s QA Findings, newest first: the judged steps of Agentic QA runs whose page or screen did not show the expected result, and the steps during which the app crashed. Not accessibility findings. Each has its QA Finding ID (qaf_…), runId (a qar_… QA run ID get_qa_run_result takes), journeyName, stepIndex, severity, instruction and status: the status of the QA ticket it landed on, which every finding of the same step content in one journey, or of the same app crash in the project, shares. Pass status to list only findings whose QA ticket has it. Pass the ID to get_qa_finding. Pages with first/after; pass pageInfo.endCursor as after to load more.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
first | Int! | yes | |
after | String | no | |
status | BACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX | no | The status of the QA ticket each finding landed on. |
list_qa_journey_groups
Section titled “list_qa_journey_groups”The project’s QA journey groups, oldest first. List a project’s QA journey groups, each with its member QA journeys and journey count. Use group IDs (qag_…) with set_qa_journey_group_members or run_qa_journey_group.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes |
list_qa_journeys
Section titled “list_qa_journeys”The project’s QA journeys, newest first. List a project’s Agentic QA journeys, newest first. Each has its QA journey ID (qaj_…), name, stepCount, locale, persona (the ID and name of the test account it signs in as, or null for a public journey), and startPath for a web journey or entry for an app journey. Pass the IDs to get_qa_journey, update_qa_journey, set_qa_journey_persona, delete_qa_journey or start_cloud_qa_audit. Pages with first/after; pass pageInfo.endCursor as after to load more.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
first | Int | no | |
after | String | no | |
details | Boolean! | no | Included when true. |
list_qa_runs
Section titled “list_qa_runs”The project’s QA runs, newest first. Runs minted under the organization that owned the project before a move stay with that organization. List a project’s Agentic QA runs, newest first. Each run has its QA run ID (qar_…), journeyId and name, state (running, completed, failed, abandoned) and verdict (clean, findings, failed, incomplete, site_blocked). Pages with first/after; pass pageInfo.endCursor as after to load more.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
first | Int | no | |
after | String | no | |
search | String | no | Literal case-insensitive run name search. |
list_scan_run_findings
Section titled “list_scan_run_findings”A stored b8e scan run, authorized against its organization. List the findings one b8e scan or b8e ci run uploaded, by the run id list_project_run_history gives its CliScan entry. They come file by file: source files first, then pages. Each has its id, fingerprint, location (a source path and line, or a page url), rule, criterion, element, evidence, description, recommendation, impact, change and seenAt. change is new or carried_over against the previous run on the run’s branch. Narrow with file and impact. Pages with first/after; pass pageInfo.endCursor as after to load more. totalCount counts every finding that matches. These findings are not tickets.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
runId | String! | yes | |
file | String | no | Only the findings in this source path or on this page URL. |
impact | critical | minor | moderate | serious | unknown | no | Only the findings of this impact. |
first | Int | no | |
after | String | no |
list_tickets
Section titled “list_tickets”List violation tickets in this organization
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
first | Int | no | |
after | String | no |
open_billing_portal
Section titled “open_billing_portal”Request a provider billing portal URL as the organization owner. The destination defaults to the general portal; returns the URL or an error.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | OpenBillingPortalInput! | yes |
organization_hint
Section titled “organization_hint”Resolve an organization id, slug or name within the viewer’s memberships.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
hint | String! | yes |
platform_admin_dashboard
Section titled “platform_admin_dashboard”Read the platform overview in capability-gated billing, users and projects sections. Requires at least one platform capability; sections without the corresponding read capability return null.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
platform_admin_overview
Section titled “platform_admin_overview”Platform-wide counts for the admin overview, readable by anyone holding at least one platform capability. Each section sits behind the capability that reads its data: organizations, subscriptions, admin activity, stuck webhook deliveries and the signup and organization series behind platform:billing:read, user counts behind platform:users:read, project counts behind platform:projects:read.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
includeBilling | Boolean! | yes | Included when true. |
includeUsers | Boolean! | yes | Included when true. |
includeProjects | Boolean! | yes | Included when true. |
platform_billing_admin
Section titled “platform_billing_admin”The calling principal’s platform capabilities, readable by anyone holding at least one. The admin surface reads this to decide which modules exist; each module’s own resolvers, not the client, are the control.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
platform_billing_open_usage_reservations
Section titled “platform_billing_open_usage_reservations”Read-only OpenUsageReservations for test and live environments, independently readable from sibling panels.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
platform_billing_organization
Section titled “platform_billing_organization”One organization’s subscription, overrides, usage periods, reservations, ledger and audit trail, addressed by its slug or its raw organization id. Null when the identifier matches no organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
identifier | ID! | yes | |
assignmentEnvironment | LIVE | TEST! | no |
platform_billing_paid_entitlement_outages
Section titled “platform_billing_paid_entitlement_outages”Read-only PaidEntitlementOutages for test and live environments, independently readable from sibling panels.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
platform_billing_webhook_health
Section titled “platform_billing_webhook_health”Read-only BillingWebhookHealth for test and live environments, independently readable from sibling panels.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
platform_organization
Section titled “platform_organization”One organization by slug or raw id, read platform-wide. Null when the identifier matches no organization.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
identifier | ID! | yes |
platform_organizations
Section titled “platform_organizations”Every organization on the platform, oldest first unless newestFirst flips it, optionally narrowed by a name, slug or id search. Platform-wide, unlike viewer.user.organizations, which is the caller’s own memberships.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
first | Int | no | |
after | String | no | |
last | Int | no | |
before | String | no | |
search | String | no | |
newestFirst | Boolean | no |
platform_project_organizations
Section titled “platform_project_organizations”Every organization that owns at least one project, by name: the options of the platform project list’s organization filter.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
platform_projects
Section titled “platform_projects”Every project on the platform with the status of its most recent run, oldest first unless newestFirst flips it, optionally narrowed to one organization, one status, one project type, projects created at or after createdSince, and a search that matches any part of a project’s name, domain or bundle id.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
first | Int | no | |
after | String | no | |
last | Int | no | |
before | String | no | |
organizationId | ID | no | |
status | done | failed | interrupted | never_ran | queued | running | no | A status the platform project list narrows to: any bucket of PlatformProjectStatus, or never_ran for a project with no run of any kind. |
createdSince | DateTime | no | |
search | String | no | |
type | android | ios | web | no | |
newestFirst | Boolean | no |
platform_user
Section titled “platform_user”One human account by id, read platform-wide. Null when the id names no human account.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
userId | ID! | yes |
platform_users
Section titled “platform_users”Every human account on the platform, oldest first unless newestFirst flips it, optionally narrowed by a name or email search and to accounts created at or after createdSince. Bot accounts are never in it.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
first | Int | no | |
after | String | no | |
last | Int | no | |
before | String | no | |
search | String | no | |
newestFirst | Boolean | no | |
createdSince | DateTime | no |
post_scan_run_pr_comment
Section titled “post_scan_run_pr_comment”Request a pull-request comment for a scan run whose findings have finished storing, using a project-authorized human or ingest credential. Returns the comment status and detail.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | PostScanRunPrCommentInput! | yes |
project_selection
Section titled “project_selection”Choose a project by id, name or domain within an organization, or return the available choices.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
organizationId | ID! | yes | |
hint | String | no |
qa_journey_group_selection
Section titled “qa_journey_group_selection”Select a project’s QA journey group by an optional hint as an organization member. Returns the selected group, choices, empty group, no groups or a refused hint.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
hint | String | no | |
projectId | ID! | yes | |
includeMembers | Boolean! | no | Included when true. |
qa_journey_selection
Section titled “qa_journey_selection”Select one QA journey by id or exact name in its project.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
hint | String! | yes |
record_qa_android_audit_diagnostics
Section titled “record_qa_android_audit_diagnostics”Store what an Android QA run’s hands saw the app log as errors. The first report of a run is kept; later ones are ignored.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RecordQaAndroidAuditDiagnosticsInput! | yes |
record_qa_audit_diagnostics
Section titled “record_qa_audit_diagnostics”Store what a QA run’s hands saw fail on the site. The first report of a run is kept; later ones are ignored.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RecordQaAuditDiagnosticsInput! | yes |
redescribe_glyph
Section titled “redescribe_glyph”Request a description workflow for one glyph and language on a page as an organization member. Returns a workflow ID; an identical request already running reuses its workflow ID.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RedescribeGlyphInput! | yes |
reject_glyph_alt
Section titled “reject_glyph_alt”Reject one glyph description as an organization member and return the reviewed description. Owner refusals are GraphQL errors. The OTHER reason requires a nonblank reason note.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RejectGlyphAltInput! | yes |
reject_organization_invite
Section titled “reject_organization_invite”Reject a pending organization invitation as its email recipient and return the invitation.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RejectOrganizationInviteInput! | yes |
remove_apple_phone
Section titled “remove_apple_phone”Remove a registered Apple phone as an organization admin or owner and return its organization or a refusal. A phone being provisioned cannot be removed.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RemoveApplePhoneInput! | yes |
remove_organization_member
Section titled “remove_organization_member”Remove one member from an organization as a platform admin, audited with the reason. Refused when it would remove the organization’s last owner.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RemoveOrganizationMemberInput! | yes |
remove_organization_membership
Section titled “remove_organization_membership”Remove a membership. Owners may remove any member; admins may remove only non-owners. The last owner cannot be removed. Returns removedMemberId on success or an error with code and message on refusal.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
memberId | ID! | yes |
remove_project_repository
Section titled “remove_project_repository”Stop binclusive[bot] commenting on a repository for this project. Members only; a CI token is refused. Stop binclusive[bot] commenting on a GitHub repository for a project.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
repo | String! | yes |
rescan_target
Section titled “rescan_target”Request another scan of a build target as an organization admin or owner. Returns the started target or a refusal, including when a scan is already pending.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RescanTargetInput! | yes |
resolve_platform_organization_id
Section titled “resolve_platform_organization_id”An organization’s raw id, resolved by id first and then slug, platform-wide.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
identifier | ID! | yes |
revoke_auth_session
Section titled “revoke_auth_session”Delete a persona’s saved session for a target as an organization admin or owner. Returns revoked false when no saved session exists.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RevokeAuthSessionInput! | yes |
revoke_organization_entitlement_override
Section titled “revoke_organization_entitlement_override”Revoke an organization entitlement override with a reason, requiring platform:billing:override. Returns the override, affected organization, warnings or refusal.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
overrideId | ID! | yes | |
reason | String! | yes |
revoke_platform_billing_capability
Section titled “revoke_platform_billing_capability”Revoke a user’s platform capability with platform:billing:override authority and a reason. Returns the remaining principal or null, and refuses removing the final holder of platform:billing:override.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | RevokePlatformBillingCapabilityInput! | yes |
revoke_project_ci_token
Section titled “revoke_project_ci_token”Revoke a project CI token by ID. Subsequent CI jobs using it are refused. Create tokens in the dashboard; the plaintext secret is shown only at creation.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
tokenId | ID! | yes |
run_journey_group
Section titled “run_journey_group”Commission one cloud accessibility audit for every member of a journey group, in group order. Every member returns its commissioned, queued, billing-refused, scan-refused or failed outcome. A member failure does not discard earlier commissions or prevent later members from being attempted. Refused for a missing, foreign or empty group. A member whose persona has no login captured is refused before starting. Capture it with b8e profile create --persona … --target … on your own machine.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
groupId | String! | yes | |
targetId | String | no | |
build | BuildInput | no | |
runOptions | RunOptions | no |
run_qa_journey_group
Section titled “run_qa_journey_group”Run a QA group as cloud requests of up to five journeys. Name an Android build once with release and dist, or its targetId. Returns each request in group order, including partial failures. Poll get_cloud_audit with the cloud audit ID.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
groupId | String! | yes | |
environment | pr | production | staging | unknown | no | |
build | BuildInput | no | |
targetId | String | no | The build target whose uploaded app each VM installs. Required on an Android project, refused on a web project. |
set_glyph_intent
Section titled “set_glyph_intent”Set a glyph’s intent to describe, decorative or excluded as an organization member. Owner refusals are GraphQL errors.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | SetGlyphIntentInput! | yes |
set_journey_group_members
Section titled “set_journey_group_members”Set the full member list of a journey group (REPLACE semantics. pass the complete desired set of journey IDs, not a delta). Returns the group with its updated journey count and members.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
groupId | String! | yes | |
journeyIds | [String!]! | yes |
set_organization_member_role
Section titled “set_organization_member_role”Change one organization member’s role as a platform admin, audited with the reason. Refused when it would demote the organization’s last owner.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | SetOrganizationMemberRoleInput! | yes |
set_project_use_cases
Section titled “set_project_use_cases”Replace the project’s use cases with the complete desired set. Requires an organization member. The set must be nonempty and supported by the project’s platform.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
useCases | [altText | ci | usability!]! | yes |
set_qa_journey_group_members
Section titled “set_qa_journey_group_members”Set the full member list of a QA journey group (REPLACE semantics. pass the complete desired set of QA journey IDs, not a delta). Returns the group with its updated journey count and members.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
groupId | String! | yes | |
journeyIds | [String!]! | yes |
set_qa_journey_group_schedule
Section titled “set_qa_journey_group_schedule”Set a QA journey group’s recurring audit schedule as an organization member. Omitted or null schedule disables scheduling; returns the updated group.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | SetQaJourneyGroupScheduleInput! | yes |
set_qa_journey_persona
Section titled “set_qa_journey_persona”Change who an Agentic QA journey signs in as, keeping its name, entry and steps. Send personaId from list_personas to use that persona, or clearPersona: true to make it public. Omitting both keeps the persona unchanged; sending personaId together with clearPersona: true is refused. A persona from another project, or one on an app journey, is refused.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
clearPersona | Boolean | no | True makes the journey public. Distinct from omitting personaId, which keeps the persona. |
journeyId | String! | yes | |
personaId | String | no | The persona the journey runs as. Omitting it keeps the journey’s persona. |
set_qa_ticket_status
Section titled “set_qa_ticket_status”Set the status of the QA ticket a QA Finding landed on: BACKLOG, TODO, IN_PROGRESS, FIXED, DONE or WONT_FIX. Every finding of the same step content in one journey, or of the same app crash in the project, shares that ticket. A new finding on a FIXED or DONE ticket reopens it to TODO; a WONT_FIX ticket stays WONT_FIX. Not an accessibility ticket. Returns the QA ticket’s id and status.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
qaFindingId | String! | yes | A QA Finding on the QA ticket to move. |
status | BACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX! | yes |
start_agentic_audit
Section titled “start_agentic_audit”Start saved accessibility journeys on a cloud VM. Name a mobile build once with release and dist, or send its targetId. The server resolves the build before commissioning. Queued runs start when a plan slot frees. Follow cloudAudit.id with get_cloud_audit, using pollAfterMs until done. A persona with no login captured is refused before starting. Capture it with b8e profile create --persona … --target … on your own machine.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
mode | EXPLORE | RECHECK | explore | recheck | no | |
projectId | ID | no | |
journeyIds | [String!] | no | |
build | BuildInput | no | |
targetId | String | no | |
runOptions | RunOptions | no | The browser options every run of a web project’s cloud audit uses. Its runner starts each with these options; an app project’s runs have none. |
start_cloud_qa_audit
Section titled “start_cloud_qa_audit”Run QA journeys on a cloud VM. Android projects need an uploaded build named by release and dist, or its targetId. The server resolves it. A queued request starts when a slot frees. Poll get_cloud_audit with the cloud audit ID. A persona with no login captured is refused before starting. Capture it with b8e profile create --persona … --target … on your own machine.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
journeyIds | [String!]! | yes | QA journey ids of this project, 1 to 5. They run one after another on one VM. |
environment | pr | production | staging | unknown | no | |
build | BuildInput | no | |
targetId | String | no | The build target whose uploaded app the VM installs. Required on an Android project, refused on a web project. |
start_glyph_scan
Section titled “start_glyph_scan”Start a glyph scan for a page and return its workflowId. Reuses the workflowId while that page already has a scan in flight. A refused start is a GraphQL error carrying the owner refusal. Read scan results later with list_page_glyphs.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
pageId | ID! | yes |
start_page_audit
Section titled “start_page_audit”Start a page capture in a cloud browser, returning the page audit ID. Analysis is started after a successful capture; capture and analysis can fail. Read progress and errors with get_page_audit. Refused when the page audit flag is off for the organization or it already has a capture running.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | ID! | yes | |
url | String! | yes |
starting_plan
Section titled “starting_plan”The published revision a brand-new workspace starts on — the trial profile when one is published, else the cheapest public plan. Null when the catalog cannot be read. Carries no organization data, so it is safe before an organization exists.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|
unban_user
Section titled “unban_user”Remove a user’s ban with platform:users:write authority and a reason. Refuses missing users and users who are not banned.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | UnbanUserInput! | yes |
update_agentic_ticket_status
Section titled “update_agentic_ticket_status”Update the status of an agentic violation ticket. FIXED marks the ticket ready for a re-check: a pass sets DONE, a fail sets TODO, and an undecided re-check leaves it FIXED.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | String! | yes | |
status | BACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX! | yes |
update_journey
Section titled “update_journey”Update an existing journey’s name, description, steps, entry (set or clear how a mobile audit enters the app), or persona. personaId changes who the journey signs in as, clearPersona: true makes it public, and omitting both keeps its persona; sending both is refused. A persona from another project, or one on a mobile app’s journey, is refused.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
clearEntry | Boolean | no | True removes the journey’s entry. Distinct from omitting entry, which leaves it alone. |
clearPersona | Boolean | no | True makes the journey public. Distinct from omitting personaId, which keeps the persona. |
description | String | no | |
entry | JSON | no | |
id | String! | yes | |
name | String | no | |
personaId | String | no | The persona the journey runs as. Omitting it keeps the journey’s persona. |
steps | [String!] | no |
update_journey_group
Section titled “update_journey_group”Update a journey group’s name or description. Does not change membership. use set_journey_group_members for that.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
description | String | no | |
id | String! | yes | |
name | String | no |
update_organization
Section titled “update_organization”Rename an organization or change its slug (requires admin role)
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes | |
name | String | no | |
slug | String | no |
update_organization_member_role
Section titled “update_organization_member_role”Change a membership’s role. Owners may change any role; admins may change only non-owner memberships to non-owner roles. The organization must keep an owner. Returns member on success or an error with code and message on refusal, including an unchanged role.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
memberId | ID! | yes | |
role | admin | member | owner! | yes |
update_project
Section titled “update_project”Update a project’s details as an organization admin or owner. Omitted fields keep their values; null clears the bot-protection token.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
id | ID! | yes | |
name | String | no | |
description | String | no | |
domain | String | no | |
bundleId | String | no | |
egressCountry | tr | us | no | |
type | android | ios | web | no | |
botProtectionToken | String | no |
update_project_page
Section titled “update_project_page”Update a tracked page as an organization member.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | UpdateProjectPageInput! | yes |
update_qa_journey
Section titled “update_qa_journey”Replace an Agentic QA journey’s name, entry and full step list by its QA journey ID. The journey keeps its ID, locale, past runs and their QA Findings. personaId changes who it signs in as; clearPersona: true makes it public; omitting both keeps its persona. Sending personaId together with clearPersona: true is refused. The journey ID determines its owning project, whose organization must include the caller. Invalid edits, an entry incompatible with that project’s platform, a persona from another project, or a persona on an app journey are refused before saving. Returns the updated journey.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
clearPersona | Boolean | no | True makes the journey public. Distinct from omitting personaId, which keeps the persona. |
entry | JSON! | yes | Where the journey starts, as @b8e/qa-contract’s QaJourneyEntry. |
journeyId | String! | yes | |
name | String! | yes | |
personaId | String | no | The persona the journey runs as. Omitting it keeps the journey’s persona. |
steps | [QaJourneyStepInput!]! | yes | Every step, in order, replacing the stored steps. |
update_qa_journey_group
Section titled “update_qa_journey_group”Update a QA journey group’s name, description, or members. Supplying journeyIds replaces the full member list; an empty list removes every member. Omitted or null fields leave their values unchanged. Returns the updated group.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
description | String | no | |
groupId | String! | yes | |
journeyIds | [String!] | no | |
name | String | no |
update_target
Section titled “update_target”Update a web target’s name, environment or base URL as an organization admin or owner. Omitted or null fields keep their values; returns the target or a refusal.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | UpdateTargetInput! | yes |
update_user
Section titled “update_user”Update your own name or job title using your browser session. At least one non-null field is required; omitted or null fields keep their values.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
input | UpdateUserInput! | yes |
widget_data
Section titled “widget_data”Get widget data for a URL. The owner validates domain ownership and widget access.
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
language | String | no | |
projectId | String | no | |
url | String! | yes |
withdraw_organization_invite
Section titled “withdraw_organization_invite”Withdraw a pending invitation to an organization (requires admin role)
Returns the operation’s GraphQL data as JSON. ID inputs accept raw or GraphQL global IDs; ID output fields return raw IDs. Nullable fields remain null; GraphQL errors return an MCP error block.
| Name | Type | Required | Notes |
|---|---|---|---|
inviteId | ID! | yes |