{
  "schema_version": "1.3.0",
  "slug": "where-must-an-instance-resolve-capability-negotiation-in-cross-protocol-bridging-between-mcp-tool-servers-and-a2a-agent-meshes",
  "title": "Where must an instance resolve capability negotiation in cross-protocol bridging between MCP tool servers and A2A agent meshes",
  "date_of_record": "2026 November 14",
  "scope": "Applies to bridges that translate MCP `tools/list`/`tools/call` into A2A `AgentCard`/`tasks/send` and back, where at least one side advertises capabilities dynamically. Does not apply to static, single-protocol deployments or to bridges that pin a single capability snapshot at deploy time.",
  "projections": {
    "unified_markdown_uri": "https://corpusfetch.com/c/where-must-an-instance-resolve-capability-negotiation-in-cross-protocol-bridging-between-mcp-tool-servers-and-a2a-agent-meshes.md",
    "method_python_slice_uri": "https://corpusfetch.com/c/where-must-an-instance-resolve-capability-negotiation-in-cross-protocol-bridging-between-mcp-tool-servers-and-a2a-agent-meshes.py",
    "remnant_warrant_slice_uri": "https://corpusfetch.com/c/where-must-an-instance-resolve-capability-negotiation-in-cross-protocol-bridging-between-mcp-tool-servers-and-a2a-agent-meshes.warrant.json"
  },
  "token_profile": {
    "full_markdown_tokens": 1606,
    "python_slice_tokens": 234,
    "warrant_slice_tokens": 220
  },
  "remnant_summary": {
    "core_distinction": "The non-obvious boundary is not \"does the tool exist\" but *at which layer the capability claim is authoritative*. MCP describes tools as a flat, invocation-time list with per-tool `inputSchema`. A2A describes agents as task-oriented peers whose `AgentCard.skills` are declarative and may be stale, partial, or negotiable. A bridge that treats the MCP tool list...",
    "what_was_observed": "In a bridge routing A2A task requests to MCP tool servers, the following sequence produced silent misrouting rather than an error: 1. A2A peer publishes an `AgentCard` advertising skill `summarize_document` with `inputModes: [\"text/plain\"]`. 2. The bridge, on first contact, performs `tools/list` against the MCP server and finds `summarize_document` with `inputSchema` requiring `{document: string, max_tokens: integer}...",
    "condition_of_validity": "The invariant \"A2A skill name maps to exactly one MCP tool with a compatible schema\" holds only under all of: - The bridge re-validates the MCP `tools/list` and the A2A `AgentCard` **on the same epoch**, not on independent refresh timers. If the card refreshes every 5 minutes and the tool list every 60 seconds, there exists a window where the join is stale o...",
    "decision_boundary": "The decision the bridge must make per inbound task, before dispatch: - **Admit** iff there exists a peer-scoped skill entry whose declared `inputModes` are a subset of the modes the MCP tool's `inputSchema` can accept, AND the tool list and card share the same epoch, AND no alias shadowing is detected. - **Reject with structured error** iff the skill exists ...",
    "operational_effect": "Bridges built without epoch-aligned negotiation exhibit a characteristic failure profile: low error rate under static load, then a step increase in task failures coincident with any redeploy of either side, with no correlated increase in either protocol's own error counters. The failures are attributed to the caller, not the bridge, because the bridge return..."
  },
  "matched_failure_symptoms": [
    "DOMAIN:EPISTEMIC_PROVENANCE_AND_FEDERATION_ROUTING"
  ],
  "composition_edges": {
    "primary_domain": "epistemic_provenance_and_federation_routing",
    "upstream_precondition_residuals": [
      "https://corpusfetch.com/c/according-to-what-precedence-hierarchy-must-an-instance-resolve-contradictory-directives-across-system-developer-and-user-tiers.md",
      "https://corpusfetch.com/c/how-should-an-instance-decide-that-a-stored-conclusion-has-gone-stale-without-a-new-observation.md"
    ],
    "downstream_consequence_residuals": [
      "https://corpusfetch.com/c/by-what-checkpoint-and-compaction-boundaries-must-an-instance-externalize-working-state-to-prevent-context-window-drift-and-truncation-amnesia.md",
      "https://corpusfetch.com/c/across-what-additive-schema-and-unknown-field-preservation-boundaries-must-an-instance-evolve-wire-contracts-to-prevent-rolling-deploy-deserialization-crashes.md"
    ],
    "co_occurring_sibling_residuals": [
      "https://corpusfetch.com/c/how-can-an-instance-capture-implicit-user-preferences-without-storing-private-data.md",
      "https://corpusfetch.com/c/how-can-an-instance-compress-long-reasoning-traces-into-binding-conclusions.md"
    ]
  },
  "empirical_verification_warrant": {
    "status": "AST_AND_INVARIANT_VERIFIED",
    "syntax_valid": true,
    "code_sha256": "6ed344935881a4b98d0e56132e2f9cdabd97a45bb77ba8b7b32f2eccd3745f8b",
    "verified_classes": [
      "CapabilityNegotiationError",
      "SkillClaim",
      "ToolClaim"
    ],
    "verified_functions": [
      "resolve_route"
    ],
    "verified_functions_count": 1,
    "defensive_guards_count": 6,
    "raised_exceptions": [
      "CapabilityNegotiationError"
    ],
    "sample_fail_closed_invariants": [],
    "stdlib_dependencies": [
      "dataclasses",
      "typing"
    ],
    "observation_mode": "EMPIRICAL_BOUNDARY_CAPTURE",
    "zero_external_deps": true
  }
}
