Add list_integrations and get_resource_content MCP tools to CLI #13231

Copilot · 2025-11-28T07:13:00Z

Description

Adds two new MCP tools to the CLI and introduces a new public API for resource agent content in Aspire.Hosting:

MCP Tools

list_integrations - Lists available Aspire hosting integrations (NuGet packages) from configured package channels, returns structured JSON with Integration schema containing short name, full package ID, and version. Description explains how to add integrations using aspire add <integration-name>.
get_resource_content - Gets agent content from a resource in the AppHost. Uses the auxiliary backchannel to invoke GetResourceAgentContentAsync RPC on the AppHost.

New Public API (Aspire.Hosting)

Introduces a new WithAgentContent API that allows resources to expose content to AI agents:

var postgres = builder.AddPostgres("pg")
    .WithAgentContent(async context =>
    {
        context.AppendLine("This is a PostgreSQL database used for user data.");
        context.AppendLine("Connection string format: Host=...;Database=...;Username=...;Password=...");
    });

AgentContentAnnotation - Annotation that stores a callback for generating agent content
AgentContentContext - Context with Resource, ServiceProvider, CancellationToken properties and AppendText()/AppendLine() methods for building content
WithAgentContent<T>() - Extension method on IResourceBuilder<T> using ResourceAnnotationMutationBehavior.Replace
All new public APIs marked with [Experimental("ASPIREAGENTCONTENT001")]

Changes

ListIntegrationsTool.cs - Uses IPackagingService to fetch packages, extracts friendly names, uses semantic versioning for correct ordering, returns structured JSON
GetResourceContentTool.cs - Uses auxiliary backchannel to invoke agent content callbacks on resources
AgentContentAnnotation.cs - New annotation and context types in Aspire.Hosting.ApplicationModel
ResourceBuilderExtensions.cs - Added WithAgentContent extension method
AuxiliaryBackchannelRpcTarget.cs - Added GetResourceAgentContentAsync RPC method
McpStartCommand.cs - Registers new tools
McpCommand.cs - Injects IPackagingService dependency
JsonSourceGenerationContext.cs - Added Integration and ListIntegrationsResponse types for AOT-compatible JSON serialization

Checklist

Is this feature complete?
- Yes. Ready to ship.
- No. Follow-up changes expected.
Are you including unit tests for the changes and scenario tests if relevant?
- Yes
- No
Did you add public API?
- Yes
  - If yes, did you have an API Review for it?
    - Yes
    - No
  - Did you add <remarks /> and <code /> elements on your triple slash comments?
    - Yes
    - No
- No
Does the change make any security assumptions or guarantees?
- Yes
  - If yes, have you done a threat model and had a security review?
    - Yes
    - No
- No
Does the change require an update in our Aspire docs?
- Yes
  - Link to aspire-docs issue (consider using one of the following templates):
- No

Original prompt

Add 2 new MCP tools to the CLI that does not talk to the app host.

A list_integrations tool that can list the integrations for the apphost
-A get_aspire_docs tool that returns the content from https://aspire.dev/llms.txt

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

davidfowl · 2025-11-28T08:27:14Z

src/Aspire.Cli/Mcp/GetAspireDocsTool.cs

+
+    public override string Name => "get_aspire_docs";
+
+    public override string Description => "Get Aspire documentation content from aspire.dev/llms.txt. This provides a comprehensive overview of .NET Aspire documentation optimized for LLMs. This tool does not require a running AppHost.";


Use Aspire not .NET Aspire.

Fixed in 66f7b8b - Changed ".NET Aspire" to "Aspire" in the description.

davidfowl · 2025-11-28T08:28:08Z

src/Aspire.Cli/Mcp/ListIntegrationsTool.cs

+
+    public override JsonElement GetInputSchema()
+    {
+        return JsonDocument.Parse("{ \"type\": \"object\", \"properties\": {} }").RootElement;


Introduce a schema for integrations.

Fixed in 66f7b8b - Added Integration class with name, packageId, and version properties, and ListIntegrationsResponse as the response schema.

davidfowl · 2025-11-28T08:29:52Z

src/Aspire.Cli/Mcp/ListIntegrationsTool.cs

+            {
+                return new CallToolResult
+                {
+                    Content = [new TextContentBlock { Text = "No Aspire hosting integrations found." }]


Don't return text, return structured content (JSON).

Fixed in 66f7b8b - Now returns structured JSON with the format {"integrations": [{"name": "Redis", "packageId": "Aspire.Hosting.Redis", "version": "9.0.0"}, ...]}

davidfowl · 2025-11-28T08:32:13Z

@copilot Implement the PR feedback

Copilot · 2025-11-28T08:41:31Z

@copilot Implement the PR feedback

Implemented in 66f7b8b - All feedback has been addressed.

davidfowl · 2025-11-28T08:48:32Z

@copilot Why does the schema from the ListIntegrationsTool and GetAspireDocsTool have no properties? For the ListIntegrationsTool we should respond with both names (long and short) and the description should describe how to add integrations to the apphost using the aspire cli.

Copilot · 2025-11-28T08:54:36Z

@copilot Why does the schema from the ListIntegrationsTool and GetAspireDocsTool have no properties? For the ListIntegrationsTool we should respond with both names (long and short) and the description...

Fixed in 2c864f1 - The input schemas now include additionalProperties: false and more descriptive text explaining that no input is required and what the tool returns. The ListIntegrationsTool already returns both the short name (name like "Redis") and the full package ID (packageId like "Aspire.Hosting.Redis"). Updated the description to include aspire add <integration-name> usage instructions.

github-actions · 2025-11-28T10:22:40Z

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 13231

Or

Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 13231"

mitchdenny · 2025-12-01T04:31:42Z

@copilot remove the GetAspireDocsTool from the CLI MCP server. instead I want you to introduce a new annotation called AgentContentAnnotation into the app model (put it in the Aspire.Hosting package.

Introduce an API that looks like this to the app model:

var myresource = builder.AddPostgres("pg")
  .WithAgentContent(async (context) => { });

The idea is that each resource can have a callback which is invoked to get text which can be returned to the agent. Introduce a new MCP tool called get_resource_content which uses the aux backchannel to invoke the callback on the AgentContentAnnotation within the app host.

The context instance will be a new type called AgentContentContext which exposes a model for appending text which is ultimately rendered to the client.

Copilot · 2025-12-01T04:48:51Z

@copilot remove the GetAspireDocsTool from the CLI MCP server. instead I want you to introduce a new annotation called AgentContentAnnotation into the app model (put it in the Aspire.Hosting package...

Implemented in eeaf179:

Removed GetAspireDocsTool from the CLI MCP server
Added AgentContentAnnotation and AgentContentContext types in Aspire.Hosting.ApplicationModel
Added WithAgentContent<T>() extension method on IResourceBuilder<T>
Added get_resource_content MCP tool that uses the aux backchannel to invoke the callback
Added IServiceProvider to AgentContentContext
Marked all new public APIs with [Experimental("ASPIREAGENTCONTENT001")]

Co-authored-by: davidfowl <[email protected]>

…ttpClient timeout Co-authored-by: davidfowl <[email protected]>

Co-authored-by: davidfowl <[email protected]>

…, return JSON Co-authored-by: davidfowl <[email protected]>

Co-authored-by: davidfowl <[email protected]>

…integrations Co-authored-by: davidfowl <[email protected]>

…ent MCP tool Co-authored-by: mitchdenny <[email protected]>

Co-authored-by: mitchdenny <[email protected]>

Copilot AI assigned Copilot and davidfowl Nov 28, 2025

Copilot started work on behalf of davidfowl November 28, 2025 07:13 View session

Copilot AI changed the title ~~[WIP] Add list_integrations and get_aspire_docs tools to CLI~~ Add list_integrations and get_aspire_docs MCP tools to CLI Nov 28, 2025

Copilot AI requested a review from davidfowl November 28, 2025 07:46

Copilot finished work on behalf of davidfowl November 28, 2025 07:46

davidfowl reviewed Nov 28, 2025

View reviewed changes

Copilot started work on behalf of davidfowl November 28, 2025 08:32 View session

Copilot finished work on behalf of davidfowl November 28, 2025 08:46

Copilot AI requested a review from davidfowl November 28, 2025 08:46

Copilot started work on behalf of davidfowl November 28, 2025 08:48 View session

Copilot finished work on behalf of davidfowl November 28, 2025 08:56

Copilot started work on behalf of mitchdenny December 1, 2025 04:32 View session

Copilot AI changed the title ~~Add list_integrations and get_aspire_docs MCP tools to CLI~~ Add list_integrations and get_resource_content MCP tools to CLI Dec 1, 2025

Copilot AI requested a review from mitchdenny December 1, 2025 04:52

Copilot finished work on behalf of mitchdenny December 1, 2025 04:52

Copilot AI and others added 5 commits December 2, 2025 09:42

Initial plan

c01891a

Add list_integrations and get_aspire_docs MCP tools

325bf3d

Co-authored-by: davidfowl <[email protected]>

Add unit tests for list_integrations and get_aspire_docs MCP tools

37b87f9

Co-authored-by: davidfowl <[email protected]>

Fix HttpClient usage to avoid port exhaustion

2037adb

Co-authored-by: davidfowl <[email protected]>

Address code review feedback: use semantic versioning and configure H…

f5a487f

…ttpClient timeout Co-authored-by: davidfowl <[email protected]>

Copilot AI and others added 9 commits December 2, 2025 09:43

Optimize version parsing to avoid redundant operations

36d6bf2

Co-authored-by: davidfowl <[email protected]>

Address PR feedback: use Aspire branding, add schema for integrations…

5d43bba

…, return JSON Co-authored-by: davidfowl <[email protected]>

Add using statement to JsonDocument in tests

a26525b

Co-authored-by: davidfowl <[email protected]>

Improve tool schemas with better descriptions and explain how to add …

879c1a4

…integrations Co-authored-by: davidfowl <[email protected]>

Replace GetAspireDocsTool with WithAgentContent and get_resource_cont…

afcfec2

…ent MCP tool Co-authored-by: mitchdenny <[email protected]>

Set annotation behavior to Replace for AgentContentAnnotation

1f384ee

Co-authored-by: mitchdenny <[email protected]>

Add some boilerplate postgres content.

312c72b

Compile error

9874ab0

WIP

27515a1

mitchdenny force-pushed the copilot/add-cli-tools-list-integrations-get-aspire-docs branch from 9ad1588 to 27515a1 Compare December 1, 2025 22:45


		public override string Name => "get_aspire_docs";

		public override string Description => "Get Aspire documentation content from aspire.dev/llms.txt. This provides a comprehensive overview of .NET Aspire documentation optimized for LLMs. This tool does not require a running AppHost.";

Add list_integrations and get_resource_content MCP tools to CLI #13231

Are you sure you want to change the base?

Add list_integrations and get_resource_content MCP tools to CLI #13231

Conversation

Copilot AI commented Nov 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

MCP Tools

New Public API (Aspire.Hosting)

Changes

Checklist

Uh oh!

davidfowl Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

davidfowl Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

davidfowl Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Nov 28, 2025

Choose a reason for hiding this comment

Uh oh!

davidfowl commented Nov 28, 2025

Uh oh!

Copilot AI commented Nov 28, 2025

Uh oh!

davidfowl commented Nov 28, 2025

Uh oh!

Copilot AI commented Nov 28, 2025

Uh oh!

github-actions bot commented Nov 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mitchdenny commented Dec 1, 2025

Uh oh!

Copilot AI commented Dec 1, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Nov 28, 2025 •

edited

Loading

github-actions bot commented Nov 28, 2025 •

edited

Loading