Skip to content

feat(mcp): application read tools#7716

Open
andypalmi wants to merge 2 commits into
feat/mcp-tools-shared-schemasfrom
feat/mcp-tools-application-read
Open

feat(mcp): application read tools#7716
andypalmi wants to merge 2 commits into
feat/mcp-tools-shared-schemasfrom
feat/mcp-tools-application-read

Conversation

@andypalmi

@andypalmi andypalmi commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Phase 1 read-only MCP tools for the application resource, added to forge/ee/lib/mcp/tools/applications.js:

  • platform_list_application_snapshots - GET /applications/:applicationId/snapshots
  • platform_export_application_audit_log - GET /applications/:applicationId/audit-log/export
  • platform_list_team_application_statuses - GET /teams/:teamId/applications/status

Each tool describes the application resource, so all three are filed with the existing application tools, following the one-file-per-resource convention. platform_export_application_audit_log is the CSV export counterpart of the already-shipped platform_get_application_audit_log. platform_list_team_application_statuses returns the applications in a team with the live status of their instances and devices.

All tools are annotated readOnlyHint: true, destructiveHint: false.

Backing scopes are already present in the user:expert-mcp allow-list (forge/routes/auth/permissions.js): project:snapshot:list, application:audit-log, team:projects:list. No allow-list changes were needed.

Closes #7690

Test plan

  • eslint on changed files passes with no errors
  • CI

@codecov

codecov Bot commented Jul 4, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 75.64%. Comparing base (103f9ae) to head (3a537c8).

Additional details and impacted files
@@                        Coverage Diff                        @@
##           feat/mcp-tools-shared-schemas    #7716      +/-   ##
=================================================================
+ Coverage                          75.41%   75.64%   +0.23%     
=================================================================
  Files                                426      426              
  Lines                              22551    22545       -6     
  Branches                            5949     5939      -10     
=================================================================
+ Hits                               17006    17054      +48     
+ Misses                              5545     5491      -54     
Flag Coverage Δ
backend 75.64% <100.00%> (+0.23%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@andypalmi andypalmi force-pushed the feat/mcp-tools-application-read branch from f5e73f5 to 0024806 Compare July 4, 2026 13:33
@andypalmi andypalmi linked an issue Jul 6, 2026 that may be closed by this pull request
@andypalmi andypalmi force-pushed the feat/mcp-tools-shared-schemas branch from 8bfb22e to 9742987 Compare July 6, 2026 13:13
@andypalmi andypalmi force-pushed the feat/mcp-tools-application-read branch from 0024806 to d9a1087 Compare July 6, 2026 16:38
Wrap the read-only application platform routes as MCP tools with unit and tool-vs-route equivalence tests. Entity ids and query-string building use the shared schema fragments.
@andypalmi andypalmi force-pushed the feat/mcp-tools-application-read branch from d9a1087 to ac0cb49 Compare July 6, 2026 22:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5.3-a Read tools (phase 1)

1 participant