Home / Servers / GitHub API / actions_create_workflow_dispatch

Create a workflow dispatch event

An MCP tool from the GitHub API server, hosted on mcp.hjlabs.in.

Create a workflow dispatch event You can use this endpoint to manually trigger a GitHub Actions workflow run. You can replace workflow_id with the workflow file name. For example, you could use main.yaml. You must configure your… [POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches]

Name on the gateway: github_api__actions_create_workflow_dispatch · may change things.

Parameters

NameTypeDescription
owner requiredstringThe account owner of the repository. The name is not case…
repo requiredstringThe name of the repository without the .git extension. The…
workflow_id requiredintegerThe ID of the workflow. You can also pass the workflow…
ref requiredstringThe git reference for the workflow. The reference can be a branch or tag name.
inputsobjectInput keys and values configured in the workflow file. The maximum number of…
return_run_detailsbooleanWhether the response should include the workflow run ID and URLs.

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "github_api__actions_create_workflow_dispatch",
  "arguments": {
    "owner": "…",
    "repo": "…",
    "workflow_id": 0,
    "ref": "…"
  }
}

Or connect the GitHub API server directly, which lists 1,221 tools including this one:

Run in your terminal
claude mcp add --transport http hj-github-api https://mcp.hjlabs.in/mcp/github-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create a workflow dispatch event tool with owner set to ….

More from GitHub API