Skip to content

Record the MCP-over-ACP method decision as blocked upstream - #42

Merged
foundev merged 1 commit into
masterfrom
claude/ecstatic-wozniak-spzo94
Sep 29, 2026
Merged

foundev merged 1 commit into
masterfrom
claude/ecstatic-wozniak-spzo94

Conversation

@foundev

@foundev foundev commented Sep 29, 2026

Copy link
Copy Markdown
Collaborator

Refs #39. This PR records the design decision #39 asked for before any code is written, and notes that implementation is waiting on an upstream schema release.

Problem

#39 asks for native MCP-over-ACP support (mcp/connect, mcp/message, mcp/disconnect) and wants the design recorded before any code. Upstream has since changed the design. agentclientprotocol/agent-client-protocol#2223 (merged Sep 25) replaced the connection-based draft that our schema-v1.23.0 / schema-v2.0.0-alpha.5 pins model with a request-scoped mcp/message binding for MCP 2026-07-28. mcp/connect and mcp/disconnect are gone from the v1 and v2 unstable schemas on upstream main, and the RFD says the earlier drafts "are not compatibility commitments". No schema release includes the change yet.

Change

Documentation only:

  • docs/unstable-facades.md: the "still open" note becomes a section that:
    • records the decision: a standard-library message mover, with no third-party MCP SDK, for the same reason agent-client-protocol-rmcp is won't port;
    • summarizes what upstream changed;
    • states that implementation waits for a schema release, per the pin workflow;
    • sketches the expected shape in mcp and v2/mcp.
  • ROADMAP.md: the remaining-gap entry now says the shape is decided and the work is blocked upstream.
  • CHANGELOG.md: adds an Unreleased entry.

The cookbook comments that mention mcp/connect/mcp/disconnect are left as they are. They describe the pinned schema accurately and still point at #39.

Validation

  • Reviewed the diff and checked the links: docs/schema-pin-workflow.md and docs/unstable-facades.md exist, and the pin-workflow wording matches its "move only when the Rust SDK moves its exact pin" trigger.
  • Checked upstream main: schema/v1/schema.unstable.json and schema/v2/schema.unstable.json contain only mcp/message, plus McpRequestId and McpError.
  • Checked the latest releases: schema-v1.23.0 and schema-v2.0.0-alpha.5 (Sep 18) are still the newest.

Remaining limits

#39 stays open. Once a schema release and a Rust SDK pin include agentclientprotocol/agent-client-protocol#2223, the issue should be rescoped to the request-scoped binding. The details are in the issue comment.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QgVQ6ZTTKi3zEMaYkm4pWr


Generated by Claude Code

Issue #39 asked for the shape decision to be recorded before any code.
The binding will be a standard-library message mover with no third-party
MCP SDK, matching the rmcp won't-port rationale.

Implementation is blocked: agentclientprotocol/agent-client-protocol#2223
replaced the pinned connection-based draft (mcp/connect, mcp/message,
mcp/disconnect) with request-scoped mcp/message for MCP 2026-07-28, and
no schema release includes it yet. Per the pin workflow, work resumes
once the Rust SDK pins a schema that does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QgVQ6ZTTKi3zEMaYkm4pWr
@foundev
foundev merged commit 52f4937 into master Sep 29, 2026
8 checks passed
@foundev
foundev deleted the claude/ecstatic-wozniak-spzo94 branch September 29, 2026 08:57
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.

2 participants