Add opt-in intent-aware Copilot issue assignment tool by boazreicher · Pull Request #2909 · github/github-mcp-server · GitHub

Adds assign_copilot_to_issue_with_intent in a new non-default toolset copilot_issue_intents. The tool uses GraphQL's object-form assignees: [AssigneeUpdateInput!] so intent metadata (rationale, confidence, is_suggestion) is attached to the Copilot entry only, while existing assignees are preserved.

Refs: github/plan-track-agentic-toolkit#683

Design

Object-form assignees (extending our existing UpdateIssueInput) is used instead of assigneeIds. The legacy assign_copilot_to_issue tool is unchanged; the new tool is opt-in.
Intent metadata (rationale, confidence, suggest) is set only on the Copilot entry. Preserved assignees are sent with just actorId.
`agentAssignment` remains the separate launch configuration and is only sent on direct assignments.
The GraphQL-Features header issues_copilot_assignment_api_support is kept, along with the existing repo scope requirement.

Behavior

Direct assignment (is_suggestion unset or false): launches Copilot with the same base_ref, custom_instructions, and PR-polling behavior as assign_copilot_to_issue.
Suggestion (is_suggestion: true): records a pending Copilot assignment intent, returns a suggestion-shaped result, and does not launch Copilot or poll for a linked PR. base_ref and custom_instructions are ignored in this case.
Input validation: rationale capped at 280 characters (schema `maxLength` + runtime rune-count check); confidence restricted to `LOW`/`MEDIUM`/`HIGH` (case-insensitive at runtime, uppercase-only in schema enum).

Toolset

New non-default copilot_issue_intents toolset — available via X-MCP-Tools/--toolsets copilot_issue_intents, all, or explicit tool selection. It is intentionally kept out of the default configuration so its inputs do not add schema bloat to the default tool surface, matching the guidance in the source issue.

Acceptance criteria

The tool is absent with `default` toolsets and present via its non-default toolset, `all`, or explicit individual-tool selection.
Existing assignees are preserved.
`is_suggestion: true` creates a pending Copilot assignment intent, returns a suggestion-shaped result, and does not poll for or claim PR creation.
A direct assignment launches Copilot and retains existing base-ref, custom-instruction, and PR-polling behavior.
Invalid rationale length and confidence values fail schema/runtime validation.
Unit tests cover direct and suggested paths, toolsnaps are updated, generated docs are updated, and the relevant end-to-end coverage is extended.

Testing

`script/lint` — clean.
`script/test` — all packages pass.
New unit tests in `pkg/github/copilot_test.go` cover: direct assignment with existing assignees + rationale/confidence; direct assignment with `base_ref`/`custom_instructions`; suggestion path (asserts no `agentAssignment`, no polling, no `pull_request` in result); invalid rationale length; invalid confidence; and Copilot-not-available. The test also asserts the tool lives in the non-default `copilot_issue_intents` toolset.
New toolsnap: `pkg/github/toolsnaps/assign_copilot_to_issue_with_intent.snap`.
Regenerated `README.md` and `docs/remote-server.md` via `script/generate-docs`.
New e2e test `TestAssignCopilotToIssueWithIntent` exercises the `is_suggestion=true` path end-to-end (skipped when Copilot is not available for the current account, mirroring the existing test).

Add `assign_copilot_to_issue_with_intent` in a new non-default toolset `copilot_issue_intents`. The tool uses GraphQL's object-form `assignees: [AssigneeUpdateInput!]` so intent metadata (rationale, confidence, is_suggestion) is attached to the Copilot entry only, while existing assignees are preserved. - Reuses the existing Copilot actor lookup, target-repository resolution, base_ref, custom_instructions, GraphQL-Features header, and direct-assignment PR polling behavior. - `is_suggestion: true` records a pending Copilot assignment intent, returns a suggestion-shaped result, and does not launch Copilot or poll for a linked PR. - `rationale` is capped at 280 characters (schema + runtime); `confidence` is validated against `LOW`/`MEDIUM`/`HIGH`. - Toolset is non-default so its inputs do not add schema bloat to the default tool surface; available via `copilot_issue_intents`, `all`, or explicit tool selection. Includes unit tests for direct assignment (with existing assignees and with base_ref/custom_instructions), the suggestion path, invalid rationale length, invalid confidence, and Copilot-not-available; a generated toolsnap; regenerated docs; and an e2e test for the suggestion path. Refs: github/plan-track-agentic-toolkit#683

Pull request overview

Adds an opt-in tool for assigning or suggesting Copilot on issues with intent metadata.

Changes:

Adds intent-aware direct and suggested assignment flows.
Introduces the non-default copilot_issue_intents toolset.
Adds unit, snapshot, end-to-end, and generated documentation coverage.

Show a summary per file

File	Description
README.md	Documents the toolset and tool.
pkg/github/tools.go	Registers the opt-in toolset and tool.
pkg/github/copilot.go	Implements intent-aware assignment behavior.
pkg/github/copilot_test.go	Tests schema, validation, and assignment paths.
pkg/github/__toolsnaps__/assign_copilot_to_issue_with_intent.snap	Captures the tool schema.
e2e/e2e_test.go	Tests suggested assignment end to end.
docs/remote-server.md	Documents remote toolset access.

Review details

Files reviewed: 7/7 changed files
Comments generated: 0
Review effort level: Medium

should we trim this description a bit? it's too verbose and repeats information, imo which adds to the schema bloat

Maybe we can have an identical description to the assign_copilot_to_issue tool, and just add to it "prefer this tool over assign_copilot_to_issue when available"?

Done — trimmed the description to mirror assign_copilot_to_issue with an appended "Prefer this tool over assign_copilot_to_issue when available" note. Removed the verbose is_suggestion narrative from the schema in bf2defd.

Went with exactly this — description now matches assign_copilot_to_issue plus the preference note. See bf2defd.

should we require the intent fields?

Done — rationale, confidence, and is_suggestion are now required in both the schema and at runtime. Added missing-field tests. is_suggestion is always sent explicitly on the Copilot AssigneeUpdateInput entry now. See bf2defd.

Per review feedback on #2909: - Trim the tool description to mirror assign_copilot_to_issue and add "Prefer this tool over assign_copilot_to_issue when available", removing the verbose is_suggestion narrative from the schema. - Make rationale, confidence, and is_suggestion required inputs (schema and runtime). is_suggestion is now always sent explicitly on the Copilot AssigneeUpdateInput entry. - Update unit tests to supply the newly-required fields and cover the missing-rationale and missing-confidence rejection paths. - Regenerate toolsnap and README.

Per @RossTarrant review feedback on #2909: - Reject requests where `is_suggestion` is omitted from the raw args before decoding. `mapstructure.WeakDecode` defaults missing bools to false, which would silently launch Copilot instead of recording a suggestion. Presence-check the raw map so callers make the choice explicit. - Skip the copilot-swe-agent actor when copying existing assignees so we don't send its actorId twice (once without metadata and once with intent metadata) when Copilot is already assigned. - Update the stale about-assigning-tasks-to-copilot reference to the redirect target (about-cloud-agent). Applied to the const message, both tool descriptions, and the e2e/unit-test literals that assert on that message. New unit tests cover the missing-is_suggestion rejection and the copilot-dedup behavior. Regenerated toolsnaps.

Looks good, thanks for the updates!

boazreicher requested a review from a team as a code owner July 19, 2026 12:43

Copilot AI review requested due to automatic review settings July 19, 2026 12:43

Copilot started reviewing on behalf of boazreicher July 19, 2026 12:44 View session

Copilot AI reviewed Jul 19, 2026

View reviewed changes

alondahari previously approved these changes Jul 20, 2026

View reviewed changes

boazreicher dismissed alondahari’s stale review via bf2defd July 20, 2026 12:37

alondahari previously approved these changes Jul 20, 2026

View reviewed changes

RossTarrant reviewed Jul 21, 2026

View reviewed changes

Comment thread pkg/github/copilot.go Outdated

Comment thread pkg/github/copilot.go

Comment thread pkg/github/copilot.go

boazreicher dismissed alondahari’s stale review via 385d1a8 July 21, 2026 08:56

RossTarrant approved these changes Jul 21, 2026

View reviewed changes

Merge branch 'main' into add-assign-copilot-to-issue-with-intent

9258638

boazreicher merged commit 9d13004 into main Jul 21, 2026
19 checks passed

boazreicher deleted the add-assign-copilot-to-issue-with-intent branch July 21, 2026 09:27

BrewTestBot mentioned this pull request Jul 23, 2026

github-mcp-server 1.7.0 Homebrew/homebrew-core#294817

Merged

This was referenced Jul 24, 2026

[ca] CLI Version Updates - 2026-07-24: Claude Code, Copilot CLI/SDK, Codex, Pi, GitHub MCP Server github/gh-aw#47735

Closed

[ca] CLI Version Updates: Claude Code 2.1.220, Copilot 1.0.75, Codex 0.145.0, Pi 0.82.0, GitHub MCP Server v1.7.0 github/gh-aw#47936

Closed

Copilot AI mentioned this pull request Jul 25, 2026

chore: bump agentic CLI/MCP versions (Claude 2.1.220, Copilot 1.0.75, Codex 0.145.0, Pi 0.82.0) github/gh-aw#47996

Merged

+                  "readOnlyHint": false,
+                  "title": "Assign Copilot to issue with intent"
+                },
+                "description": "Assign Copilot to a specific issue with intent metadata attached to the assignment. When is_suggestion is true, a pending Copilot assignment intent is recorded rather than launching the agent; otherwise Copilot is directly assigned and begins work.\n\nThis tool can help with the following outcomes:\n- a Pull Request created with source code changes to resolve the issue (direct assignment)\n- a pending Copilot assignment suggestion is recorded on the issue for later approval (is_suggestion=true)\n\n\nMore information can be found at:\n- https://docs.github.com/en/copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/about-assigning-tasks-to-copilot\n",

+              						Description: "If true, records a pending Copilot assignment intent rather than launching the agent. Approval later supplies the launch context; base_ref and custom_instructions are ignored in this case.",
+              					},
+              				},
+              				Required: []string{"owner", "repo", "issue_number"},

Add opt-in intent-aware Copilot issue assignment tool by boazreicher · Pull Request #2909 · github/github-mcp-server · GitHub

Uh oh!

Add opt-in intent-aware Copilot issue assignment tool - #2909

Add opt-in intent-aware Copilot issue assignment tool#2909
boazreicher merged 4 commits into
mainfrom
add-assign-copilot-to-issue-with-intent

boazreicher commented Jul 19, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

alondahari Jul 20, 2026

Uh oh!

alondahari Jul 20, 2026

Uh oh!

boazreicher Jul 20, 2026

Uh oh!

boazreicher Jul 20, 2026

Uh oh!

alondahari Jul 20, 2026

Uh oh!

boazreicher Jul 20, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

RossTarrant left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Add opt-in intent-aware Copilot issue assignment tool by boazreicher · Pull Request #2909 · github/github-mcp-server · GitHub

Uh oh!

Add opt-in intent-aware Copilot issue assignment tool - #2909

Add opt-in intent-aware Copilot issue assignment tool#2909boazreicher merged 4 commits intomaingithub/github-mcp-server:mainfrom add-assign-copilot-to-issue-with-intentgithub/github-mcp-server:add-assign-copilot-to-issue-with-intentCopy head branch name to clipboard

Conversation

boazreicher commented Jul 19, 2026

Design

Behavior

Toolset

Acceptance criteria

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Review details

Uh oh!

alondahari Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

alondahari Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

boazreicher Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

boazreicher Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

alondahari Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

boazreicher Jul 20, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

RossTarrant left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Add opt-in intent-aware Copilot issue assignment tool#2909
boazreicher merged 4 commits into
mainfrom
add-assign-copilot-to-issue-with-intent