CI access tools
Five tools for a project’s CI access: the CI tokens its CI jobs submit findings with, and the GitHub
repositories binclusive[bot] may comment on.
A CI token is created in the dashboard, never over MCP. The dashboard shows a new token’s secret
once, to the person who created it. No tool on this server creates a token or returns a token’s
secret: list_project_ci_tokens returns each token’s first characters and dates, never the token.
list_project_ci_tokens
Section titled “list_project_ci_tokens”List a project’s CI tokens, newest first.
| Name | Type | Required |
|---|---|---|
project_id | string | yes |
Returns: { ciTokens }. Each entry carries id, name, start (the token’s first
characters, to tell tokens apart), enabled, expired, expiresAt, remainingDays,
lastRequest, createdAt and createdByEmail.
Returns an error block reading Project "<project_id>" not found when the project cannot be reached.
revoke_project_ci_token
Section titled “revoke_project_ci_token”Revoke one of a project’s CI tokens. A CI job using it is refused from then on.
| Name | Type | Required | Notes |
|---|---|---|---|
token_id | string | yes | A token’s id from list_project_ci_tokens. |
Returns: the confirmation line Revoked CI token: <token_id>.
Returns an error block reading CI token not found when the project has no such token.
list_project_ci_repositories
Section titled “list_project_ci_repositories”List the GitHub repositories binclusive[bot] may comment on for a project.
| Name | Type | Required |
|---|---|---|
project_id | string | yes |
Returns: { repositories }. Each entry carries repo (lowercase owner/name), source and
allowedAt. source is MEMBER when an organization member allowed the repository, and HISTORY
when it was copied from the repositories the project’s CI scans already commented on.
Returns an error block reading Project "<project_id>" not found when the project cannot be reached.
allow_project_repository
Section titled “allow_project_repository”Allow binclusive[bot] to comment on a GitHub repository for a project.
| Name | Type | Required | Notes |
|---|---|---|---|
project_id | string | yes | |
repository | string | yes | owner/name, the repository’s GitHub URL, or its SSH remote. |
Returns: { repository }, carrying repo, source and allowedAt.
The repository must be in the organization’s GitHub App installation. When it is not, when the App is not installed, or when GitHub cannot be reached, the error block carries the reason and what to do about it, and nothing is saved.
remove_project_repository
Section titled “remove_project_repository”Stop binclusive[bot] commenting on a GitHub repository for a project.
| Name | Type | Required | Notes |
|---|---|---|---|
project_id | string | yes | |
repository | string | yes | owner/name, the repository’s GitHub URL, or its SSH remote. |
Returns: the confirmation line Removed repository: <repository>.