Docsmcp
GitHub MCP Server
Connect FlowTrux workflows to GitHub issues, pull requests, repos, and Actions
The GitHub MCP server provides 12 tools for managing repositories, issues, pull requests, and GitHub Actions.
Setup
- Create a Personal Access Token (fine-grained recommended).
- Grant permissions: Issues (read/write), Pull requests (read/write), Actions (read/write), Contents (read).
- In FlowTrux, go to Settings > MCP Servers > Add > GitHub.
- Paste the token. Optionally set a default owner/org.
Tools
Repositories
| Tool | Description | Required Params |
|---|---|---|
list_repos | List repositories for user or org | (none - uses default owner) |
get_repo | Get repository details | owner, repo |
Issues
| Tool | Description | Required Params |
|---|---|---|
list_issues | List issues (with state/label filters) | owner, repo |
get_issue | Get a single issue | owner, repo, issue_number |
create_issue | Create an issue | owner, repo, title |
update_issue | Update issue (title, body, state, labels) | owner, repo, issue_number |
add_issue_comment | Add a comment to an issue | owner, repo, issue_number, body |
Pull Requests
| Tool | Description | Required Params |
|---|---|---|
list_pull_requests | List PRs (with state filter) | owner, repo |
get_pull_request | Get a single PR | owner, repo, pull_number |
create_pull_request | Create a PR | owner, repo, title, head, base |
GitHub Actions
| Tool | Description | Required Params |
|---|---|---|
list_workflows | List Actions workflows | owner, repo |
trigger_workflow | Trigger a workflow dispatch | owner, repo, workflow_id, ref |
Examples
Auto-create issue from AI analysis:
Webhook (error alert) → Agent (analyze error) → Action:MCP(github, create_issue, {owner: "myorg", repo: "backend", title: "{{steps.agent-1.output.response.title}}", body: "{{steps.agent-1.output.response.analysis}}", labels: ["bug", "auto-detected"]})
Trigger deploy after approval:
Webhook → Generate Callback → Slack (approve button) → Wait for Callback → Action:MCP(github, trigger_workflow, {owner: "myorg", repo: "infra", workflow_id: "deploy.yml", ref: "main"})