Skip to content

Conversation

@nikomatsakis
Copy link
Contributor

This splits out the proxy support from MCP-over-ACP, as they are conceptually distinct, and produces two independent RFDs.

Extract MCP transport mechanism from proxy-chains RFD into standalone
mcp-over-acp.mdx. This separation reflects that MCP-over-ACP is useful
for any ACP component, not just proxies.

New mcp-over-acp.mdx covers:
- ACP as MCP transport type (transport: acp with UUID)
- Capability advertising via mcpCapabilities.acp
- mcp/connect, mcp/message, mcp/disconnect protocol
- Bridging for agents without native support

proxy-chains.mdx now references mcp-over-acp for MCP-specific details
and focuses on the proxy architecture and conductor design.
- Rewrite status quo to clarify ACP/MCP relationship (front/behind framing)
- Add capability advertisement flow to 'How it works' section
- Add 'Bridging and compatibility' subsection early in the doc
- Rename uuid field to id (no format restriction)
- Rename acpUrl to acpId (simpler, no acp: prefix)
- Link mcpCapabilities to schema docs
- Rename to 'Agent Extensions via ACP Proxies'
- Lead with agent extensions concept, proxies as mechanism
- Tighten status quo section (~50% shorter)
- Move MCP-over-ACP content to FAQ with bridging explanation
- Add diagrams showing proxy chain structure and conductor abstraction
- Define terminal vs non-terminal roles upfront
- Explain conductor's role and reference canonical Rust implementation
- Minor wording improvements throughout
@nikomatsakis nikomatsakis requested a review from a team as a code owner January 8, 2026 00:10
Copy link
Contributor

@codefromthecrypt codefromthecrypt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is interesting work. I will share it with the transports interest group in MCP since this is about adding a new transport and has overlap with other routine things like the wasm question.

one nit is maybe we should rename the proxy-chain doc as well?

(this isn't a full review, just a note as I looked at this briefly)

@benbrandt benbrandt enabled auto-merge (squash) January 8, 2026 10:34
@benbrandt benbrandt merged commit e685daf into agentclientprotocol:main Jan 8, 2026
1 check passed
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.

3 participants