github / github/github-mcp-server

Add deterministic toolset resolution ordering for default and custom toolsets

Open
#2,104 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Go
Stars
33k
Forks
5k
Avg merge
2d 1h
Merged PRs (30d)
52

Description

Problem
Toolset resolution with overlapping include/exclude/default inputs can produce non-deterministic exposure ordering, making policy verification and reproducibility harder.

Why now
Predictable capability exposure is required for governance and deterministic client behavior.

Expected behavior
Given equivalent config, resolved toolset ordering is deterministic and testable.

Acceptance criteria
- Toolset resolution emits stable ordering for equivalent inputs.
- Overlapping include/exclude resolution remains semantically correct.
- Tests cover default+custom overlap scenarios.

Evidence packet
- Commit under test: bf6467855c13d3b8f5cf72f8dfd9c86f8336b20b
- Runtime environment: macOS Darwin 25.3.0 arm64, Go 1.25.7
- Minimal repro:
1. Resolve toolsets repeatedly with same include/exclude config.
2. Compare resolved tool list order.
- Expected: deterministic stable order.
- Actual: ordering is not guaranteed by contract/tests.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.