Skip to content

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 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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
inputAcceptOrganizationInviteInput!yes

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.

NameTypeRequiredNotes
projectIdID!yes
repoString!yesThe repository as owner/name, its GitHub URL, or its SSH remote.

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.

NameTypeRequiredNotes
inputApproveGlyphAltInput!yes

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.

NameTypeRequiredNotes
inputArchiveTargetInput!yes

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.

NameTypeRequiredNotes
idString!yes
assigneeIdStringno

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.

NameTypeRequiredNotes
projectIdID!yes
personaString!yes
targetString!yes

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.

NameTypeRequiredNotes
inputBanUserInput!yes

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes
runIdString!yes

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.

NameTypeRequiredNotes
cloudRunRequestIdString!yes

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.

NameTypeRequiredNotes
organizationIdID!yes
planVersionIdID!yes
cadenceANNUAL | MONTHLY!yes
decisionKeyString!yesOpaque precondition from usageAndLimits.purchase. Missing or changed previews are refused before sending to the provider.

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.

NameTypeRequiredNotes
slugString!yes

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.

NameTypeRequiredNotes
includeQaBoolean!noIncluded when true.

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.

NameTypeRequiredNotes
projectIdID!yes
scheduledaily | monthly | weeklyno

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.

NameTypeRequiredNotes
disable[String!]no
enable[String!]no
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
sitemapSitemapConfigInput!yes

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.

NameTypeRequiredNotes
projectIdID!yes
ticketLanguageStringno

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.

NameTypeRequiredNotes
projectIdID!yes
widgetWidgetConfigurationInput!yes

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.

NameTypeRequiredNotes
descriptionStringno
entryJSONno
nameString!yes
personaIdStringno
projectIdID!yes
steps[String!]no

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.

NameTypeRequiredNotes
pageAuditIdID!yes
projectIdID!yes
revisionInt!yesThe 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 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.

NameTypeRequiredNotes
descriptionStringno
nameString!yes
projectIdID!yes

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.

NameTypeRequiredNotes
nameString!yes
slugString!yes

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.

NameTypeRequiredNotes
projectIdID!yesa raw prj_… id or a base64 Project global id
urls[String!]!yes

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.

NameTypeRequiredNotes
pageAuditIdID!yes
projectIdID!yes
revisionInt!yesThe 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 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.

NameTypeRequiredNotes
nameString!yes
projectIdID!yes
testAccountAcknowledgedBoolean!yesMust be true. The caller confirms this persona logs in as a dedicated test account, not a real person’s.

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.

NameTypeRequiredNotes
bundleIdStringno
descriptionStringno
domainStringno
egressCountrytr | usno
nameString!yes
organizationIdID!yesa raw Organization id or a base64 Organization global id
typeandroid | ios | web!yes
useCases[altText | ci | usability!]!yes

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.

NameTypeRequiredNotes
inputCreateProjectPageInput!yes

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.

NameTypeRequiredNotes
descriptionStringno
journeyIds[String!]no
nameString!yes
projectIdID!yes

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.

NameTypeRequiredNotes
inputCreateTargetInput!yes

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.

NameTypeRequiredNotes
criterionStringno
descriptionString!yes
elementString!yes
evidenceString!yes
impactcritical | minor | moderate | serious | unknown!yes
locationAuthoredLocationInput!yes
projectIdString!yes
recommendationString!yes

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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
ids[ID!]!yes

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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
idID!yes

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.

NameTypeRequiredNotes
idID!yesa raw prjpg_… id or a base64 ProjectPage global id

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.

NameTypeRequiredNotes
journeyString!yes
projectIdIDno

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.

NameTypeRequiredNotes
groupIdString!yes

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.

NameTypeRequiredNotes
languages[String!]!yes
pageIdID!yes

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.

NameTypeRequiredNotes
inputDismissProjectSetupBandInput!yes

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.

NameTypeRequiredNotes
inputEditGlyphAltInput!yes

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.

NameTypeRequiredNotes
inputGenerateEvidenceExportInput!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.

NameTypeRequiredNotes
keys[FlagInput!]!yes
organizationIdIDnoOptional route-scoped organization. When supplied, the caller must be a member and org/role targeting is evaluated against this org.

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.

NameTypeRequiredNotes
fontUrlString!yes
organizationIdID!yes

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.

NameTypeRequiredNotes
includeTicketsBooleannoInclude deduplicated tickets. Requires organization membership; false returns the report without tickets, as its runner may read it.
includeDetailsBooleannoIncluded when true.
runIdString!yesa raw run_… id or a base64 AgenticRun global id
firstIntno
ticketsAfterStringno
findingsAfterStringno
resultsAfterStringno
notesAfterStringno

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.

NameTypeRequiredNotes
runIdID!yesa raw run_… id or a base64 AgenticRun global id

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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
runIdString!yes

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.

NameTypeRequiredNotes
idID!yes

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.

NameTypeRequiredNotes
slugString!yes

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.

NameTypeRequiredNotes
organizationIdID!yes

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.

NameTypeRequiredNotes
idID!yes

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
languageString!yes

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
idString!yes

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.

NameTypeRequiredNotes
journeyIdString!yes

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.

NameTypeRequiredNotes
runIdString!yesa raw qar_… id or a base64 QaAuditRun global id

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.

NameTypeRequiredNotes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
keyString!yes

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.

NameTypeRequiredNotes
organizationIdID!yes
entitlementKeyString!yes
valueString!yes
expiresAtString!yes
reasonString!yes
operationADD | DISABLE | ENABLE | REPLACE!no
scopeORGANIZATION | PLATFORM_EMERGENCY!no
startsAtStringno
ticketStringnoThe issue this grant answers. Free-text today, so the audit trail carries a pointer rather than only a sentence.

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.

NameTypeRequiredNotes
inputGrantPlatformBillingCapabilityInput!yes

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.

NameTypeRequiredNotes
findingIdString!yes

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.

NameTypeRequiredNotes
journeysJSON!yesThe journey file: a list of journeys as @b8e/qa-contract defines them.
personaIdStringnoThe 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.
projectIdID!yes
requestKeyStringnoIdentifies one import request. Re-sending the same key to the same project returns the journeys the first request created instead of creating them again.

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.

NameTypeRequiredNotes
projectIdID!yes
sitemapUrlString!yes

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.

NameTypeRequiredNotes
emailString!yes
organizationIdID!yes
roleadmin | member!yes

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.

NameTypeRequiredNotes
organizationIdID!yes

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.

NameTypeRequiredNotes
organizationIdID!yes
statusBACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIXno
platformandroid | ios | react_native | unity | unknown | webno
priorityP0 | P1 | P2 | P3no
firstIntno
afterStringno

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 —target .

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.

NameTypeRequiredNotes
projectIdID!yes
includeRetiredBoolean!noIncluded when true.

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
organizationIdID!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
organizationIdID!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
idID!yes
groupcoveragePlan | needsReview | notTested | resolved!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
pageIdID!yes
languageString!yes
filterNEEDS_ATTENTION | REJECTEDno
types[audio | button | iframe | img | input | link | other | video!]no
intentdecorative | describe | excludednoReviewer intent for the glyph. describe = needs alt text; decorative = intentionally empty; excluded = out of scope.
firstIntno
afterStringno

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.

NameTypeRequiredNotes
projectIdID!yes
firstIntno
afterStringno
searchStringnoCase-insensitive URL substring filter.

List the project’s test account personas and their captured sessions per deployment. Capture login with b8e profile create —persona —target .

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
repoString!yes
prNumberInt!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
projectIdID!yes
statusBACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIXno
platformandroid | ios | react_native | unity | unknown | webno
priorityP0 | P1 | P2 | P3no
firstIntno
afterStringno

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
firstInt!yes
afterStringno
searchStringnoLiteral case-insensitive journey name search. A nonempty search omits CLI scans, which have no journey.
runningOnlyBooleannoOnly queued or running audits.
includeUnfinishedBooleannoInclude 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 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.

NameTypeRequiredNotes
projectIdID!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
organizationIdID!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
projectIdID!yes
firstInt!yes
afterStringno
statusBACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIXnoThe status of the QA ticket each finding landed on.

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.

NameTypeRequiredNotes
projectIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
firstIntno
afterStringno
detailsBoolean!noIncluded when true.

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.

NameTypeRequiredNotes
projectIdID!yes
firstIntno
afterStringno
searchStringnoLiteral case-insensitive run name search.

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.

NameTypeRequiredNotes
runIdString!yes
fileStringnoOnly the findings in this source path or on this page URL.
impactcritical | minor | moderate | serious | unknownnoOnly the findings of this impact.
firstIntno
afterStringno

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.

NameTypeRequiredNotes
organizationIdID!yes
firstIntno
afterStringno

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.

NameTypeRequiredNotes
inputOpenBillingPortalInput!yes

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.

NameTypeRequiredNotes
hintString!yes

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes
includeBillingBoolean!yesIncluded when true.
includeUsersBoolean!yesIncluded when true.
includeProjectsBoolean!yesIncluded when true.

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes
identifierID!yes
assignmentEnvironmentLIVE | TEST!no

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes
identifierID!yes

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.

NameTypeRequiredNotes
firstIntno
afterStringno
lastIntno
beforeStringno
searchStringno
newestFirstBooleanno

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes
firstIntno
afterStringno
lastIntno
beforeStringno
organizationIdIDno
statusdone | failed | interrupted | never_ran | queued | runningnoA status the platform project list narrows to: any bucket of PlatformProjectStatus, or never_ran for a project with no run of any kind.
createdSinceDateTimeno
searchStringno
typeandroid | ios | webno
newestFirstBooleanno

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.

NameTypeRequiredNotes
userIdID!yes

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.

NameTypeRequiredNotes
firstIntno
afterStringno
lastIntno
beforeStringno
searchStringno
newestFirstBooleanno
createdSinceDateTimeno

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.

NameTypeRequiredNotes
inputPostScanRunPrCommentInput!yes

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.

NameTypeRequiredNotes
organizationIdID!yes
hintStringno

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.

NameTypeRequiredNotes
hintStringno
projectIdID!yes
includeMembersBoolean!noIncluded when true.

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.

NameTypeRequiredNotes
projectIdID!yes
hintString!yes

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.

NameTypeRequiredNotes
inputRecordQaAndroidAuditDiagnosticsInput!yes

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.

NameTypeRequiredNotes
inputRecordQaAuditDiagnosticsInput!yes

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.

NameTypeRequiredNotes
inputRedescribeGlyphInput!yes

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.

NameTypeRequiredNotes
inputRejectGlyphAltInput!yes

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.

NameTypeRequiredNotes
inputRejectOrganizationInviteInput!yes

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.

NameTypeRequiredNotes
inputRemoveApplePhoneInput!yes

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.

NameTypeRequiredNotes
inputRemoveOrganizationMemberInput!yes

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.

NameTypeRequiredNotes
memberIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
repoString!yes

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.

NameTypeRequiredNotes
inputRescanTargetInput!yes

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.

NameTypeRequiredNotes
identifierID!yes

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.

NameTypeRequiredNotes
inputRevokeAuthSessionInput!yes

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.

NameTypeRequiredNotes
overrideIdID!yes
reasonString!yes

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.

NameTypeRequiredNotes
inputRevokePlatformBillingCapabilityInput!yes

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.

NameTypeRequiredNotes
tokenIdID!yes

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.

NameTypeRequiredNotes
groupIdString!yes
targetIdStringno
buildBuildInputno
runOptionsRunOptionsno

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.

NameTypeRequiredNotes
groupIdString!yes
environmentpr | production | staging | unknownno
buildBuildInputno
targetIdStringnoThe build target whose uploaded app each VM installs. Required on an Android project, refused on a web project.

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.

NameTypeRequiredNotes
inputSetGlyphIntentInput!yes

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.

NameTypeRequiredNotes
groupIdString!yes
journeyIds[String!]!yes

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.

NameTypeRequiredNotes
inputSetOrganizationMemberRoleInput!yes

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.

NameTypeRequiredNotes
projectIdID!yes
useCases[altText | ci | usability!]!yes

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.

NameTypeRequiredNotes
groupIdString!yes
journeyIds[String!]!yes

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.

NameTypeRequiredNotes
inputSetQaJourneyGroupScheduleInput!yes

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.

NameTypeRequiredNotes
clearPersonaBooleannoTrue makes the journey public. Distinct from omitting personaId, which keeps the persona.
journeyIdString!yes
personaIdStringnoThe persona the journey runs as. Omitting it keeps the journey’s persona.

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.

NameTypeRequiredNotes
qaFindingIdString!yesA QA Finding on the QA ticket to move.
statusBACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX!yes

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.

NameTypeRequiredNotes
modeEXPLORE | RECHECK | explore | recheckno
projectIdIDno
journeyIds[String!]no
buildBuildInputno
targetIdStringno
runOptionsRunOptionsnoThe 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.

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.

NameTypeRequiredNotes
journeyIds[String!]!yesQA journey ids of this project, 1 to 5. They run one after another on one VM.
environmentpr | production | staging | unknownno
buildBuildInputno
targetIdStringnoThe build target whose uploaded app the VM installs. Required on an Android project, refused on a web project.

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.

NameTypeRequiredNotes
pageIdID!yes

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.

NameTypeRequiredNotes
projectIdID!yes
urlString!yes

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.

NameTypeRequiredNotes

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.

NameTypeRequiredNotes
inputUnbanUserInput!yes

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.

NameTypeRequiredNotes
idString!yes
statusBACKLOG | DONE | FIXED | IN_PROGRESS | TODO | WONT_FIX!yes

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.

NameTypeRequiredNotes
clearEntryBooleannoTrue removes the journey’s entry. Distinct from omitting entry, which leaves it alone.
clearPersonaBooleannoTrue makes the journey public. Distinct from omitting personaId, which keeps the persona.
descriptionStringno
entryJSONno
idString!yes
nameStringno
personaIdStringnoThe persona the journey runs as. Omitting it keeps the journey’s persona.
steps[String!]no

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.

NameTypeRequiredNotes
descriptionStringno
idString!yes
nameStringno

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.

NameTypeRequiredNotes
idID!yes
nameStringno
slugStringno

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.

NameTypeRequiredNotes
memberIdID!yes
roleadmin | member | owner!yes

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.

NameTypeRequiredNotes
idID!yes
nameStringno
descriptionStringno
domainStringno
bundleIdStringno
egressCountrytr | usno
typeandroid | ios | webno
botProtectionTokenStringno

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.

NameTypeRequiredNotes
inputUpdateProjectPageInput!yes

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.

NameTypeRequiredNotes
clearPersonaBooleannoTrue makes the journey public. Distinct from omitting personaId, which keeps the persona.
entryJSON!yesWhere the journey starts, as @b8e/qa-contract’s QaJourneyEntry.
journeyIdString!yes
nameString!yes
personaIdStringnoThe persona the journey runs as. Omitting it keeps the journey’s persona.
steps[QaJourneyStepInput!]!yesEvery step, in order, replacing the stored steps.

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.

NameTypeRequiredNotes
descriptionStringno
groupIdString!yes
journeyIds[String!]no
nameStringno

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.

NameTypeRequiredNotes
inputUpdateTargetInput!yes

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.

NameTypeRequiredNotes
inputUpdateUserInput!yes

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.

NameTypeRequiredNotes
languageStringno
projectIdStringno
urlString!yes

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.

NameTypeRequiredNotes
inviteIdID!yes