ref
(string): The reference to run the workflow on (branch, tag, or SHA)
How to use it
ref is exposed by the Github Actions MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the ref tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Github Actions MCP Server
npm install -g typescriptOther tools in Github Actions MCP Server (15)
(optional string): Filter by user who triggered the workflow
(optional string): Filter by branch
(optional number): Filter by check suite ID
(optional string): Filter by creation date (YYYY-MM-DD)
(optional string): Filter by event type
(optional boolean): Exclude PR-triggered runs
(optional string): Filter jobs by completion status ('latest', 'all')
(optional object): Input parameters for the workflow
(string): Repository owner (username or organization)
(optional number): Page number for pagination
(optional number): Results per page (max 100)
(string): Repository name
(number): The ID of the workflow run
(optional string): Filter by status
(string or number): The ID of the workflow or filename