Skip to content

feat(mcp): catalog read tools - #7721

Draft
andypalmi wants to merge 2 commits into
feat/mcp-tools-shared-schemasfrom
feat/mcp-tools-catalog-read
Draft

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

Conversation

@andypalmi

@andypalmi andypalmi commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Read tools for the platform catalogs, added to forge/ee/lib/mcp/tools/platform.js. Adds get-by-id lookups (the list variants already exist) and the team-type catalog reads:

  • platform_get_hosted_instance_type - GET /project-types/:instanceTypeId
  • platform_get_stack - GET /stacks/:stackId
  • platform_get_template - GET /templates/:templateId
  • platform_get_blueprint - GET /flow-blueprints/:flowBlueprintId
  • platform_list_team_types - GET /team-types
  • platform_get_team_type - GET /team-types/:teamTypeId

Team types are a global platform catalog with no team in the path, mirroring project-types, so they are filed with the platform catalog tools following the one-file-per-resource convention. All tools are readOnlyHint: true, destructiveHint: false.

Scopes allow-listed for user:expert-mcp in forge/routes/auth/permissions.js:

  • stack:read
  • template:read
  • flow-blueprint:read
  • team-type:list
  • team-type:read

(project-type:read was already allow-listed.)

Closes #7679

Test plan

  • eslint on changed files passes
  • 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.61%. Comparing base (103f9ae) to head (0bc2dce).

Additional details and impacted files
@@                        Coverage Diff                        @@
##           feat/mcp-tools-shared-schemas    #7721      +/-   ##
=================================================================
+ Coverage                          75.41%   75.61%   +0.19%     
=================================================================
  Files                                426      426              
  Lines                              22551    22576      +25     
  Branches                            5949     5949              
=================================================================
+ Hits                               17006    17070      +64     
+ Misses                              5545     5506      -39     
Flag Coverage Δ
backend 75.61% <100.00%> (+0.19%) ⬆️

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-catalog-read branch from 439e08b to 5d7e091 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-catalog-read branch from 5d7e091 to a46d91f Compare July 6, 2026 16:38
Add read-only MCP tools to fetch a stack, instance type, template or flow blueprint by id, with unit and equivalence tests. Allow-list their scopes for the expert-mcp platform token.
@andypalmi
andypalmi force-pushed the feat/mcp-tools-catalog-read branch from a46d91f to 138f496 Compare July 6, 2026 22:01
@andypalmi
andypalmi marked this pull request as draft July 30, 2026 08:20
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.10 Catalog completeness

1 participant