TraconMcpServerExtensions

Namespace Tracon · Assembly Tracon.AspNetCore.dll

Extensions that connect the HTTP endpoint that publishes Tracon agents as MCP tools.

public static class TraconMcpServerExtensions

Inheritance

object ← TraconMcpServerExtensions

Inherited Members

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Fields

DefaultPattern

Default path.

public const string DefaultPattern = "/tracon/mcp"

Field Value

string

Methods

MapTraconMcpServer(IEndpointRouteBuilder, string)

Publishes the exposed agents in the catalog as MCP tools.

public static IEndpointConventionBuilder MapTraconMcpServer(this IEndpointRouteBuilder endpoints, string pattern = "/tracon/mcp")

Parameters

endpoints IEndpointRouteBuilder

The application’s routing builder.

pattern string

Path. Default is /tracon/mcp.

Returns

IEndpointConventionBuilder

The endpoint’s convention builder.

Remarks

Applies the SAME three-layer protection as MapTracon (loopback + bearer token + authorization policy) — settings are inherited from there, a second settings set is not built.

If AllowRemoteAccess is enabled this fails at startup. A single static token is not enough for an exposed agent surface.

If an exposed agent carries a tool that requires approval the application STILL fails — but not synchronously from this method, rather through Tracon.McpApprovalGuardFilter: the check waits in the background until the SQL schema is ready (so this method itself does not crash with “no such table” against an empty database, the same pattern), completes by the first request, and no request can get ahead of it.

app.MapTracon();
app.MapTraconMcpServer();

Exceptions

ArgumentNullException

endpoints is null.

ArgumentException

pattern is empty.

InvalidOperationException

UseMcpServer or MapTracon has not been called first, or this is called while remote access is enabled.