[mcp-analysis] MCP Structural Analysis - 2026-06-30

[github-actions[bot]]

GitHub MCP Structural Analysis — 2026-06-30

Tested 12 representative tools across 11 toolsets against github/gh-aw. Average usefulness 4.00/5 today; total measured payload 7,111 tokens. Six tools earned a perfect 5/5 for agentic work (get_label, list_branches, list_discussions, search_users, search_repositories, actions_list).

Notable this run: the actions and users toolsets were reachable for the first time in weeks (prior runs hit permission-denied on actions). get_me still fails with a 403 under the integration token. The two heaviest responses — list_code_scanning_alerts (3,336 tok) and list_issues (2,164 tok) — together account for 77% of today's total tokens, driven by embedded rule.help markdown and unbounded issue bodies respectively.

Metric	Value
Tools analyzed	12
Total tokens (today)	7,111
Average usefulness rating	4.00 / 5
Best rated	6 tools tied at 5/5 (most efficient: get_label, 40 tok)
Worst rated	get_me: 1/5 (403) · list_code_scanning_alerts: 2/5 (bloat)

Recommendations

• High-value tools (4–5): get_label, list_branches, search_repositories, list_discussions, search_users, actions_list, get_file_contents, list_commits, list_pull_requests.
• Needs improvement: list_code_scanning_alerts — strip/optional rule.help & full_description markdown (≈80% of payload, duplicated across alerts sharing a rule); list_issues — add a body-excerpt/truncation flag; get_me — unusable under the integration token, agents should read identity from github-context instead.
• Context-efficient (low tokens + high rating): list_branches (30 tok), get_label (40), search_users (65), search_repositories (117), actions_list (132), list_discussions (151) — all 5/5.
• Context-heavy (use with filters/pagination): list_code_scanning_alerts (3,336), list_issues (2,164), get_file_contents (scales with file size).

Full Structural Analysis Report

Executive Summary

Metric	Value
Tools Analyzed	12
Total Tokens (Today)	7,111
Average Usefulness Rating	4.00/5
Best Rated Tool	get_label: 5/5 @ 40 tok (most efficient of the 5/5 group)
Worst Rated Tool	get_me: 1/5 (403 Resource not accessible by integration)

Usefulness Ratings for Agentic Work

Tool	Toolset	Rating	Assessment
get_label	labels	⭐⭐⭐⭐⭐	Tiny flat lookup, node id for GraphQL chaining
list_branches	repos	⭐⭐⭐⭐⭐	Minimal, includes protection flag
actions_list	actions	⭐⭐⭐⭐⭐	Compact workflow discovery (method dispatch)
list_discussions	discussions	⭐⭐⭐⭐⭐	Cursor pagination + totalCount, body excluded
search_users	users	⭐⭐⭐⭐⭐	Minimal item shape, no bloat
search_repositories	search	⭐⭐⭐⭐⭐	minimal_output: all discovery signals
get_file_contents	repos	⭐⭐⭐⭐	Resource envelope w/ SHA; scales with file
list_commits	repos	⭐⭐⭐⭐	Compact; minor author-field duplication
list_pull_requests	pull_requests	⭐⭐⭐⭐	Rich triage data; base/head repo redundancy
list_issues	issues	⭐⭐⭐	Actionable but full body inflates size
list_code_scanning_alerts	code_security	⭐⭐	rule.help markdown dominates payload
get_me	context	⭐	403 under integration token — unusable

Schema Analysis

Tool	Type	Depth	Key Fields	Notes
get_me	error	2	content, isError	403 error envelope
get_file_contents	object	3	resource, text, uri, sha	Clean resource envelope
list_commits	array	4	sha, commit.message, author.login	Author at two levels
list_branches	array	2	name, sha, protected	Flat, ideal
list_issues	array	3	number, title, state, body, user	Body unbounded
list_pull_requests	array	4	number, base.ref, head.ref, draft, merged	base/head embed full repo
actions_list	object	3	total_count, workflows[].path, state	Needs method param
list_code_scanning_alerts	array	4	number, rule, most_recent_instance.location	rule.help bloat
list_discussions	object	3	discussions[], pageInfo, totalCount	GraphQL-style
get_label	object	1	name, color, description, id	Flattest schema
search_users	object	3	total_count, items[].login, items[].id	Minimal items
search_repositories	array	3	full_name, language, stargazers_count, topics	No URL bloat

Response Size Analysis (today)

Toolset	Avg Tokens	Tools Tested
code_security	3,336	list_code_scanning_alerts
issues	2,164	list_issues
pull_requests	503	list_pull_requests
repos	188	get_file_contents, list_commits, list_branches
discussions	151	list_discussions
actions	132	actions_list
search	117	search_repositories
users	65	search_users
labels	40	get_label
context	38	get_me

Tool-by-Tool Analysis

Tool	Toolset	Tokens	Schema	Rating	Notes
get_me	context	38	error	1	403 'Resource not accessible by integration'; derive identity from github-context
get_file_contents	repos	345	object	4	LICENSE in resource envelope w/ mimeType+uri+sha; no range read
list_commits	repos	190	array	4	Compact at perPage=1; author duplicated commit.author + top-level
list_branches	repos	30	array	5	Minimal flat list with protection flag
list_issues	issues	2,164	array	3	Full body always included; templated issue ballooned payload
list_pull_requests	pull_requests	503	array	4	base/head refs, draft/merged flags; embedded repo redundancy
actions_list	actions	132	object	5	totalCount=330; path+state per workflow; requires method dispatch
list_code_scanning_alerts	code_security	3,336	array	2	rule.help full markdown (CWE refs + Go examples) ≈80% of payload
list_discussions	discussions	151	object	5	Cursor pagination, totalCount=7889; body excluded
get_label	labels	40	object	5	Tiny flat lookup; node id for GraphQL chaining
search_users	users	65	object	5	Minimal items (login,id,profile_url,avatar_url)
search_repositories	search	117	array	5	minimal_output default; all discovery signals, no URL bloat

30-Day Trend Summary

Metric	Value
Data Points	162
Distinct Days	18 (2026-06-01 → 2026-06-30)
Average Daily Tokens	7,360
Overall Average Rating	3.46/5
Rating Trend (first 5 days → last 5 days)	3.49 → 3.52 (stable, +0.04)

30-day per-toolset average response size (tokens): code_security 2,156 · issues 1,792 · repos 1,222 · pull_requests 968 · actions 432 · search 372 · discussions 180 · labels 124 · users 65 · context 23.

Visualizations

Usefulness Ratings by Toolset

Average Response Size by Toolset

Daily Token Trend (30-day window)

Size vs Usefulness

References: §28444453172

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🔍 GitHub MCP Structural Analysis · 250.9 AIC · ⌖ 16.3 AIC · ⊞ 9.8K · ◷

• expires on Jul 1, 2026, 4:45 AM UTC-08:00

[github-actions[bot]]

This discussion has been marked as outdated by GitHub MCP Structural Analysis.

A newer discussion is available at Discussion #42750.