Finding tools

create_ticket

File an accessibility finding and its ticket into Binclusive. It arrives the same way one filed by hand in the dashboard does, tagged origin: mcp so you can tell agent-filed findings from scanner output later.

This is the one tool a machine (b8e_) credential can reach.

Name	Type	Required	Notes
project_id	string	yes	Project to file the finding under.
organization_id	string	conditional	Required when signed in as a user; optional with a machine credential. See below.
location	object	yes	A page or source location — see Vocabularies.
criterion	string	no	WCAG success-criterion id, e.g. 1.4.3. Omit for a non-WCAG-mapped issue. Non-empty when present.
element	string	yes	DOM selector / accessible-tree path locating the occurrence. Non-empty.
evidence	string	yes	What was observed at the element.
impact	enum	yes	critical | serious | moderate | minor | unknown.
description	string	yes	Plain-language description of the issue.
recommendation	string	yes	How to fix it — prose, not code.

Which organization it files into

Signed in as	organization_id	What happens
A person	Required	You may belong to several organizations, so you have to say which. Omit it and the call is refused with create_ticket needs organization_id when signed in as a user — call list_organizations and pass the id of the organization to file into.
A machine (b8e_)	Optional	The credential already names one organization. Pass an id anyway and it is checked against the credential; a mismatch is refused, not redirected.

Take the id from list_organizations, not get_viewer — get_viewer returns a single organization, and it is the oldest one rather than one you chose.

Returns: { findingId, ticket }, where the ticket carries id, url, element, description, impact, wcagCriterion, status, priority, provenance, and createdAt.

Errors. With no credential present at all: create_ticket needs a credential to forward — none present. Sign in, or present a machine (b8e_) token. Otherwise the underlying error comes back in full — a rejected impact value, a credential not allowed to file findings, or a project or organization it cannot reach.