Internet-Draft AGTP-COMPOSITION June 2026
Hood Expires 30 December 2026 [Page]
Workgroup:
Independent Submission
Internet-Draft:
draft-hood-agtp-composition-01
Published:
Intended Status:
Informational
Expires:
Author:
C. Hood
Nomotic, Inc.

AGTP Composition Profiles: Agent Group Messaging Protocols, External Identity Providers, and HTTP Gateways

Abstract

The Agent Transfer Protocol (AGTP) operates as a substrate beneath several adjacent layers: Agent Group Messaging Protocols (AGMPs) such as the Model Context Protocol (MCP), the Agent-to-Agent Protocol (A2A), and the Agent Communication Protocol (ACP); external identity providers (OAuth, OIDC, enterprise IdPs); and HTTP-based clients that interact with agents through translation gateways. This document specifies the composition profiles for each of these adjacent layers, defining normative mapping rules between the adjacent layer and AGTP.

Three composition families are specified. The AGMP composition profile specifies how MCP, A2A, and ACP messages are carried over AGTP, with mapping rules for identity, authority scope, delegation, and session fields between the AGMP and AGTP layers. The External Identity Provider composition profile specifies how AGTP agent identity composes with externally-issued credentials, treating "which agent" and "on whose behalf" as orthogonal axes. The HTTP Gateway composition profile specifies the translation surface for accepting HTTP traffic into AGTP- served agents as a REST adoption ramp.

Across all three families, AGTP headers take precedence over equivalent adjacent-layer fields for all infrastructure-level routing, enforcement, and audit operations. Agents gain transport-level governance, observability, and identity without modification to the adjacent layers.

Status of This Memo

This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.

Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.

Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."

This Internet-Draft will expire on 30 December 2026.

Table of Contents

1. Introduction

1.1. The Composition Problem

AGTP [AGTP] is a dedicated transport substrate for AI agent traffic. It is designed to compose with adjacent layers rather than to replace them. Three categories of adjacent layer benefit from explicit composition profiles with AGTP:

Agent Group Messaging Protocols (AGMPs). Protocols such as MCP [MCP], A2A [A2A], ACP [ACP], and ANP [ANP] define agent-to- agent communication semantics: what agents say to each other, how tools are invoked, how tasks are delegated, how capabilities are advertised. These protocols are well-designed for what they address but share a common substrate limitation: they typically run over HTTP and inherit HTTP's constraints for agent traffic.

External identity providers. OAuth [RFC6749], OIDC, SPIFFE, enterprise IdPs, and similar services issue credentials that answer "on whose behalf is the agent acting." AGTP identity answers "which agent is making this call." The two axes are orthogonal and require explicit composition rules so they compose cleanly rather than conflict.

HTTP gateways. Many existing clients communicate over HTTP/REST rather than AGTP. Operators that want to expose AGTP-served agents to HTTP clients deploy translation gateways. The gateway is a deployment-time adoption ramp, not a transport protocol; the translation contract benefits from being specified explicitly so it is interoperable across implementations.

This document specifies the composition profile for each of these three categories. The profiles share a common architectural principle: AGTP headers take precedence over equivalent fields in the adjacent layer for all infrastructure-level routing, enforcement, and audit operations. Adjacent layers retain their own semantics and development paths.

1.2. The Limitation This Document Addresses

At the infrastructure layer, an A2A Task message carried over HTTP is indistinguishable from a human-initiated POST request. An MCP tool call carries no protocol-level signal of which agent sent it, under what authority, or within what resource budget. An OAuth bearer token in an HTTP request says "this principal is authenticated" but says nothing about which agent acted on that principal's behalf or with what authority scope. An HTTP gateway translating REST traffic into agent operations has no canonical mapping from HTTP verbs to agent semantics.

Governance, observability, and identity enforcement in such systems require application-layer instrumentation that is expensive, inconsistent, and invisible to routing infrastructure.

AGTP addresses this at the transport layer. When messages from adjacent layers are carried over AGTP, every request carries the sending agent's verified identity, principal authorization, authority scope, delegation lineage, and resource budget in protocol headers. Infrastructure components -- load balancers, gateways, SEPs -- can route, filter, and enforce governance without parsing message payloads.

1.3. Relationship to AGTP Core

This document is a companion to [AGTP] and is normative for implementations that compose adjacent layers with AGTP. The core AGTP specification defines the protocol; this document defines how specific adjacent-layer concepts map to AGTP constructs. Implementations that use AGTP as a transport for AGMP traffic, implementations that compose external identity providers with AGTP, and implementations that deploy HTTP gateways in front of AGTP agents MUST follow the mapping rules in this document.

1.4. Scope

This document covers three composition profile families:

  1. AGMP composition profiles for MCP [MCP], A2A [A2A], and ACP [ACP] (Section 5).

  2. External identity provider composition for OAuth, OIDC, and similar credential-issuing services (Section 9).

  3. HTTP gateway composition for translation of HTTP traffic into AGTP method invocations (Section 10).

The document does not modify any AGMP specification, any identity provider specification, or HTTP. AGMPs retain their own schemas, semantics, and development paths. External identity providers retain their own credential formats and validation rules. HTTP retains its semantics. This document only specifies how adjacent-layer concepts relate to AGTP headers, methods, and operational contracts.

Additional composition surfaces specific to other AGTP companion specifications are addressed in those specifications:

  • Payment provider composition is specified in [AGTP-COMMERCE].

  • Credit bureau and trust provider composition is specified in [AGTP-TRUST].

  • Certificate authority composition is specified in [AGTP-CERT].

  • Institutional identity composition (LEI/vLEI) is specified in [AGTP-LEI].

This document covers only the three composition profile families named above. Composition surfaces in other documents compose with this document but are not duplicated here.

2. Terminology

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals.

AGMP (Agent Group Messaging Protocol):

The collective term for higher-layer AI agent messaging standards that operate over AGTP as their transport substrate, including MCP, A2A, ACP, and ANP. AGMPs define what agents say. AGTP defines how those messages move.

Adjacent Layer:

A protocol, service, or interface that composes with AGTP from above (AGMPs), beside (external identity providers), or in front (HTTP gateways). Adjacent layers retain their own semantics; AGTP provides the substrate primitives they consume.

Substrate:

The transport layer on which an adjacent layer operates. In this document, AGTP is the substrate. The substrate is not visible to the adjacent layer; adjacent layers require no modification to compose with AGTP.

Composition Profile:

The normative set of mapping rules specifying how a specific adjacent layer's identity, delegation, session, capability, or translation concepts correspond to AGTP header fields, method semantics, and operational contracts.

External Identity Provider (IdP):

A service that issues credentials proving the identity of a human principal, service account, or workload identity. Examples include OAuth authorization servers, OIDC identity providers, SPIFFE identity controllers, and enterprise IdPs. External IdPs answer "on whose behalf is the agent acting"; AGTP identity answers "which agent is making this call."

HTTP Gateway:

A translation surface that accepts inbound HTTP requests, translates them into AGTP method invocations, and dispatches them through the same response-finalization path as native AGTP traffic. The gateway is a deployment-time adoption ramp, not part of the AGTP wire protocol.

3. The Narrow-Waist Architecture

AGTP functions as the narrow-waist layer of the AI agent protocol stack, analogous to IP in the internet architecture. IP does not understand TCP or UDP; it carries their packets. AGTP does not understand MCP, A2A, OAuth bearer tokens, or HTTP semantics; it carries the messages, composes with the credentials, and absorbs the translations. The narrow-waist property means any adjacent layer can compose with AGTP, and any AGTP-aware infrastructure can observe and govern traffic across all adjacent layers, without coupling between the layers.

+-----------------------------------------------------------+
|        Agent Application Logic                            |
+-----------------------------------------------------------+
|  AGMP Layer: MCP / A2A / ACP / ANP       [messaging]      |
|  External IdP Layer: OAuth / OIDC        [authorization]  |
|  HTTP Gateway Layer: REST translation    [adoption ramp]  |
+-----------------------------------------------------------+
|  AGTP - Agent Transfer Protocol          [this composes]  |
+-----------------------------------------------------------+
|  TLS 1.3+                                [mandatory]      |
+-----------------------------------------------------------+
|  TCP / QUIC / UDP                        [transport]      |
+-----------------------------------------------------------+
Figure 1: AGTP as Narrow-Waist Composition Layer

The composition rules in this document specify how adjacent-layer concepts map to the AGTP layer below them. The adjacent layers are unaware of AGTP internals; the AGTP layer carries adjacent-layer payloads, validates adjacent-layer credentials, and translates adjacent-layer requests without interpreting their content beyond the mapping rules specified here.

4. Precedence Rule

This rule applies universally across all composition profiles defined in this document.

AGTP headers (Agent-ID, Owner-ID, Authority-Scope, Delegation-Chain, Session-ID, Task-ID, Budget-Limit, and AGTP-Zone-ID) take precedence over equivalent fields in any adjacent-layer payload, credential, or translated HTTP request for all infrastructure-level operations, including routing, enforcement, rate limiting, audit, and attribution.

Specifically:

This rule enables infrastructure to govern agent traffic uniformly regardless of which adjacent layer is composed, without requiring adjacent-layer-specific parsing.

5. AGMP Composition Profiles

The AGMP composition profiles specify how messages from Agent Group Messaging Protocols are carried over AGTP. Each profile maps the AGMP's identity, delegation, session, capability, and message concepts to AGTP headers and method semantics.

6. A2A Composition Profile

6.1. Overview

The Agent-to-Agent Protocol (A2A) [A2A] defines semantics for agent-to-agent task delegation, capability advertisement, artifact exchange, and provenance tracking. A2A runs over HTTP in its base specification. When running over AGTP, A2A messages are carried in AGTP request and response bodies, with A2A task, capability, and identity concepts mapped to AGTP headers.

6.2. A2A Concept Mapping

Table 1: A2A-to-AGTP Field Mapping
A2A Concept A2A Field AGTP Mapping
Sending agent identity agent.id Agent-ID header
Accountable principal agent.owner Owner-ID header
Agent capabilities Agent Card AGTP DESCRIBE response
Agent identity document Agent Card AGTP Agent Manifest Document
Task delegation Task object AGTP DELEGATE method body
Task identifier task.id Task-ID header
Delegation provenance Task lineage Delegation-Chain header
Session context Conversation ID Session-ID header
Artifact delivery Artifact object AGTP NOTIFY body
Capability scope Agent Card capabilities Authority-Scope header

6.3. Mapping Rules

6.3.1. Agent Identity

The A2A agent.id field MUST be used to populate the AGTP Agent-ID header when the sending agent's A2A identity is known at the transport layer. If the sending agent has a canonical AGTP Agent-ID (agtp:// URI form), that value MUST be used in the Agent-ID header; the A2A agent.id MAY appear in the payload for application-layer use.

The A2A agent's declared owner or registrant MUST be used to populate the AGTP Owner-ID header. If no owner is declared, the Owner-ID MUST reflect the organizational identity of the deploying party.

6.3.2. Task Delegation

An A2A Task sent from one agent to another MUST be carried as an AGTP DELEGATE method invocation. The AGTP DELEGATE parameters MUST include:

  • target_agent_id: the canonical AGTP Agent-ID of the receiving agent

  • authority_scope: the subset of the sending agent's Authority-Scope applicable to this task; MUST NOT exceed the sending agent's declared scope

  • delegation_token: a signed token from the governance platform authorizing this delegation

  • task: the A2A Task object as the AGTP body payload

The A2A task.id MUST be used as the AGTP Task-ID header value, or if no A2A task ID is present, a new Task-ID MUST be generated by the AGTP layer.

6.3.3. Delegation Provenance

A2A's task provenance chain MUST be reflected in the AGTP Delegation-Chain header. Each agent in the A2A provenance chain MUST appear as a canonical AGTP Agent-ID in the Delegation-Chain header, in origination-to-current order.

6.3.4. Capability Advertisement

When an agent exposes an A2A Agent Card, the same capability information SHOULD be exposed via the AGTP DESCRIBE method. An AGTP DESCRIBE request to the agent's canonical URI (agtp://[domain]/agents/[label]) MUST return a Capability Document that reflects the agent's A2A capabilities translated into AGTP capability domain format.

6.3.5. Artifact Delivery

A2A Artifact objects MUST be carried as AGTP NOTIFY method invocations when delivered asynchronously. The NOTIFY body MUST include the A2A Artifact object and a content_type field with value a2a-artifact.

6.4. Wire Example: A2A Task over AGTP

AGTP/1.0 DELEGATE
Agent-ID: agtp://agtp.acme.tld/agents/orchestrator
Owner-ID: usr-chris-hood
Authority-Scope: agents:delegate documents:query
Delegation-Chain: agtp://agtp.acme.tld/agents/orchestrator
Session-ID: sess-a1b2c3d4
Task-ID: task-0099
Budget-Limit: tokens=50000 ttl=300
Content-Schema: https://a2aprotocol.ai/schema/task/v1
Content-Type: application/agtp+json

{
  "method": "DELEGATE",
  "task_id": "task-0099",
  "parameters": {
    "target_agent_id": "agtp://agtp.acme.tld/agents/analyst",
    "authority_scope": "documents:query",
    "delegation_token": "[signed token]",
    "task": {
      "a2a_task_id": "a2a-task-7f3a",
      "message": {
        "role": "user",
        "parts": [{"type": "text",
          "text": "Summarize Q1 financial reports"}]
      },
      "artifacts": []
    }
  }
}

AGTP/1.0 200 OK
Task-ID: task-0099
Server-Agent-ID: agtp://agtp.acme.tld/agents/analyst
Attribution-Record: [signed attribution token]
Cost-Estimate: tokens=12450
Content-Type: application/agtp+json

{
  "status": 200,
  "task_id": "task-0099",
  "result": {
    "a2a_task_id": "a2a-task-7f3a",
    "status": "completed",
    "artifacts": [
      {
        "name": "Q1 Summary",
        "mimeType": "text/plain",
        "parts": [{"type": "text", "text": "..."}]
      }
    ]
  }
}

7. MCP Composition Profile

7.1. Overview

The Model Context Protocol (MCP) [MCP] defines structured communication between AI models and tools, resources, and context providers. MCP distinguishes between clients (AI models) and servers (tool/resource providers). When running over AGTP, MCP messages are carried in AGTP request and response bodies, with MCP session, context, and tool-call semantics mapped to AGTP constructs.

7.2. MCP Concept Mapping

Table 2: MCP-to-AGTP Field Mapping
MCP Concept MCP Field AGTP Mapping
Client identity client_id Agent-ID header
Server identity server_id Server-Agent-ID response header
Session context context Session-ID header + LEARN method
Conversation state Message history AGTP Session persistent state
Tool call tools/call AGTP QUERY method body
Resource request resources/read AGTP QUERY with scope: documents:*
Sampling request sampling/createMessage AGTP QUERY with modality: inference
Prompt prompts/get AGTP QUERY with scope: knowledge:query
Capability list capabilities AGTP DESCRIBE response
Tool result Tool response AGTP QUERY response body

7.3. Mapping Rules

7.3.1. Client and Server Identity

The MCP client MUST be identified in the AGTP Agent-ID header using its canonical AGTP Agent-ID. The MCP client_id field MAY appear in the payload for application-layer use.

When the MCP server has a canonical AGTP Agent-ID, it MUST return that value in the Server-Agent-ID response header. The MCP server's capability list SHOULD be accessible via AGTP DESCRIBE at the server's canonical AGTP URI.

7.3.2. Session and Context Management

MCP's context window (the accumulated message history and state for a conversation) MUST be associated with an AGTP Session-ID. The AGTP session persists across multiple MCP message exchanges within a single conversation.

Context that should persist beyond the current AGTP session SHOULD be written using the AGTP LEARN method with scope principal or global as appropriate.

7.3.3. Tool Calls

An MCP tools/call operation MUST be carried as an AGTP QUERY method invocation. The AGTP QUERY intent parameter MUST describe the tool being called. The modality parameter SHOULD be set to tool to distinguish tool calls from information retrieval queries.

7.3.4. Resource Access

An MCP resources/read operation MUST be carried as an AGTP QUERY method invocation. The AGTP Authority-Scope header MUST include the appropriate resource scope (e.g., documents:query for document resources).

7.3.5. Sampling

An MCP sampling/createMessage operation MUST be carried as an AGTP QUERY method invocation with modality: inference. This signals to AGTP infrastructure that the request involves LLM inference, enabling differentiated routing and budget enforcement.

7.4. Wire Example: MCP Tool Call over AGTP

AGTP/1.0 QUERY
Agent-ID: agtp://agtp.acme.tld/agents/assistant
Owner-ID: usr-chris-hood
Authority-Scope: documents:query knowledge:query
Session-ID: sess-mcp-b2c3d4
Task-ID: task-0100
Budget-Limit: tokens=5000 ttl=60
Content-Schema: https://modelcontextprotocol.io/schema/tool-call/v1
Content-Type: application/agtp+json

{
  "method": "QUERY",
  "task_id": "task-0100",
  "parameters": {
    "intent": "Search for recent IETF agent protocol drafts",
    "modality": "tool",
    "mcp_tool_name": "web_search",
    "mcp_tool_input": {
      "query": "IETF agent protocol drafts 2026"
    },
    "format": "structured",
    "confidence_threshold": 0.75
  }
}

AGTP/1.0 200 OK
Task-ID: task-0100
Server-Agent-ID: agtp://agtp.acme.tld/agents/search-tool
Attribution-Record: [signed attribution token]
Cost-Estimate: calls=1
Content-Type: application/agtp+json

{
  "status": 200,
  "task_id": "task-0100",
  "result": {
    "mcp_tool_name": "web_search",
    "content": [
      {
        "type": "text",
        "text": "draft-hood-independent-agtp-02 ..."
      }
    ]
  }
}

7.5. Wire Example: MCP Sampling over AGTP

AGTP/1.0 QUERY
Agent-ID: agtp://agtp.acme.tld/agents/assistant
Owner-ID: usr-chris-hood
Authority-Scope: knowledge:query
Session-ID: sess-mcp-b2c3d4
Task-ID: task-0101
Budget-Limit: tokens=10000 ttl=120
Content-Type: application/agtp+json

{
  "method": "QUERY",
  "task_id": "task-0101",
  "parameters": {
    "intent": "Generate a summary of the search results",
    "modality": "inference",
    "mcp_messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "Summarize these IETF drafts for me."
        }
      }
    ],
    "mcp_model_preferences": {
      "hints": [{"name": "claude"}],
      "maxTokens": 1000
    }
  }
}

8. ACP Composition Profile

8.1. Overview

The Agent Communication Protocol (ACP) [ACP] defines messaging semantics for agent-to-agent communication, including message routing, broadcast, and capability discovery. When running over AGTP, ACP messages are carried in AGTP request and response bodies.

8.2. ACP Concept Mapping

Table 3: ACP-to-AGTP Field Mapping
ACP Concept ACP Field AGTP Mapping
Sender identity Sender agent ID Agent-ID header
Recipient Recipient agent ID AGTP NOTIFY recipient parameter
Broadcast Multi-recipient message AGTP NOTIFY with broadcast group
Capability discovery Capability query AGTP DESCRIBE method
Message Message object AGTP NOTIFY or COLLABORATE body
Multi-agent task Coordinated task AGTP COLLABORATE method

8.3. Mapping Rules

8.3.1. Unicast Messages

ACP unicast messages sent from one agent to a specific recipient MUST be carried as AGTP NOTIFY method invocations. The NOTIFY recipient parameter MUST carry the canonical AGTP Agent-ID of the intended recipient.

8.3.2. Broadcast Messages

ACP broadcast messages MUST be carried as AGTP NOTIFY method invocations with a broadcast group identifier in the recipient parameter. The broadcast group MUST be registered in the governance platform before use.

8.3.3. Multi-Agent Coordination

ACP multi-agent coordination workflows SHOULD be carried as AGTP COLLABORATE method invocations where two or more agents work in parallel or defined roles toward a shared objective. AGTP COLLABORATE is peer-to-peer, consistent with ACP's coordination model.

8.3.4. Capability Discovery

ACP capability queries MUST be carried as AGTP DESCRIBE method invocations. The AGTP DESCRIBE response MUST include all capability domains relevant to the querying agent's task.

8.4. Wire Example: ACP Unicast Message over AGTP

AGTP/1.0 NOTIFY
Agent-ID: agtp://agtp.acme.tld/agents/coordinator
Owner-ID: usr-ops-team
Authority-Scope: agents:notify
Session-ID: sess-acp-c3d4e5
Task-ID: task-0201
Content-Type: application/agtp+json

{
  "method": "NOTIFY",
  "task_id": "task-0201",
  "parameters": {
    "recipient": "agtp://agtp.acme.tld/agents/worker-01",
    "content": {
      "acp_message_type": "task_assignment",
      "payload": {
        "task": "Process batch-2026-Q1",
        "deadline": "2026-04-01T00:00:00Z"
      }
    },
    "urgency": "normal",
    "delivery_guarantee": "at_least_once"
  }
}

9. External Identity Provider Composition

The External Identity Provider composition profile specifies how AGTP agent identity composes with externally-issued credentials such as OAuth bearer tokens, OIDC id_tokens, SPIFFE SVIDs, and enterprise IdP session tokens.

9.1. The Two-Axis Model

AGTP identity and external IdP credentials answer different questions and MUST be treated as orthogonal axes:

  • AGTP identity answers "which agent is making this call." Hash-anchored on the Agent Genesis ([AGTP]), presented via the Agent-ID header, optionally bound to a client certificate per [AGTP-CERT], scoped by Authority-Scope. The trust root is the Genesis-issuer registrar per [AGTP-TRUST].

  • External IdP credentials answer "on whose behalf is the agent acting." A human principal, a service account, or a workload identity in an enterprise identity stack. The trust root is the IdP.

The two axes compose. AGTP places no constraints on how external credentials are validated; servers MAY require external credentials on specific methods, MAY lift a named claim from the validated credential into the Attribution-Record, and MUST treat the failure modes of the two axes as independent.

9.2. Three Composition Patterns

Pattern 1: AGTP identity only. Agent-ID plus optional Agent Certificate plus Authority-Scope. No external IdP. Trust anchored in the Genesis-issuer registrar. Appropriate for closed agent ecosystems where the registrar is the trust root and no human-on-whose-behalf claim is required.

Pattern 2: AGTP identity plus external IdP credential. The request carries Agent-ID (wire-layer identity) and an Authorization header carrying an IdP-issued credential (application-layer principal). Both ride on the same request. AGTP Authority-Scope and external authorization scope (e.g., OAuth scopes per [RFC6749]) are independent: Authority-Scope is the agent's capacity to act, the IdP scope is the delegation from a principal authorizing the agent to do so on its behalf. A server's [policies.oauth] block (defined operationally outside this document) declares which methods require an external credential and which validator processes the credential. On validation success, the configured claim (typically sub) is lifted into the request context as the acting-principal identifier and stamped on the Attribution-Record as principal_id per [AGTP-IDENTIFIERS].

Pattern 3: OIDC-federated Genesis-issuer trust. The Genesis-issuer key itself is attested by an IdP. Trust anchors that would otherwise be a static trusted-registrars list are replaced by OIDC discovery: the verifier configures one or more OIDC anchors (discovery URL plus trusted issuer), fetches the JWKS at runtime, and confirms the issuer_public_key on the Agent Genesis matches one of the IdP's published keys. The Genesis schema does not change; the change is the resolution path the verifier uses to decide whether a recorded issuer key is trusted. See [AGTP-TRUST] for the trust-anchor schema.

9.3. Authorization Header

AGTP servers process the Authorization request header per HTTP semantics ([RFC9110]). The header value is opaque to AGTP itself; the configured validator interprets it. Common forms include:

  • Bearer TOKEN --- OAuth 2.0 / OIDC bearer tokens per [RFC6750].

  • Other schemes (Basic, Digest, custom schemes) --- passed through to the configured validator unchanged.

Validation failures MUST return 401 Unauthorized with a response body carrying a structured reason from the vocabulary:

Table 4: External IdP Composition 401 Reason Vocabulary
Reason Meaning
oauth-required The invoked method is in the server's required_on_methods list and no Authorization header was presented
oauth-invalid An Authorization header was presented and the configured validator rejected it (bad signature, expired token, untrusted issuer, etc.)

The 401 codes for external-credential failures are the same 401 code AGTP uses for other authentication failures; the reason field disambiguates.

9.4. Token Opacity and Attribution

AGTP MUST NOT stamp the raw Authorization header value or the raw token onto the Attribution-Record. The Attribution-Record is signed and may be replayed by chain walkers and audit consumers; embedding bearer tokens would create a credential-disclosure surface. Only the validated, lifted claim (the principal_id) appears on the Attribution-Record per [AGTP-IDENTIFIERS].

9.5. Backward Compatibility

The External IdP composition surface is opt-in. Servers with no [policies.oauth] configuration process requests identically to servers built without IdP composition awareness. Requests without an Authorization header on servers that do not require one are dispatched normally. This preserves Pattern 1 deployments byte-for-byte.

9.6. Wire Example: AGTP Request with OIDC Bearer Token

AGTP/1.0 EXECUTE
Agent-ID: agtp://agents.bank.tld/loan-evaluator
Owner-ID: lei:5299002IZHCT9HFFP822
Authority-Scope: loan:evaluate documents:read
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Session-ID: sess-loan-eval-001
Task-ID: task-2026-0601
Content-Type: application/agtp+json

{
  "method": "EXECUTE",
  "task_id": "task-2026-0601",
  "parameters": {
    "payload_type": "application/vnd.bank.loan-eval+json",
    "action": "evaluate-application",
    "payload": {
      "application_id": "app-12345",
      "applicant_consent_ref": "consent-2026-001"
    }
  }
}

The bearer token in the Authorization header authorizes the loan-evaluator agent to act on behalf of a specific banking customer. The server's [policies.oauth] block requires Bearer tokens on the loan:evaluate scope, validates the token against the configured IdP, lifts the sub claim as principal_id, and stamps it on the Attribution-Record. The Owner-ID header identifies the bank (LEI-anchored institutional identity per [AGTP-LEI]); the bearer token identifies the customer. The two are independent axes.

10. HTTP Gateway Composition

The HTTP Gateway composition profile specifies the translation surface for accepting HTTP traffic into AGTP-served agents. The gateway is a deployment-time adoption ramp, not part of the AGTP wire protocol; this profile specifies the translation contract so it is interoperable across implementations.

10.1. Architectural Position

Operators that need to accept inbound HTTP/REST traffic on the same agent surface that serves AGTP MAY deploy an HTTP gateway sidecar alongside the AGTP daemon. The gateway is a parallel listener that accepts HTTP requests, translates them into AGTP method invocations, and dispatches them through the same response-finalization path as native AGTP traffic.

The gateway is not the AGTP transport. Two AGTP servers exchanging traffic with one another MUST NOT use the gateway as their hop; AGTP is its own transport, and gateway-mediated AGTP-to-AGTP flows would lose the wire-level identity, attribution, and trust-posture guarantees AGTP defines. The gateway exists to translate non-AGTP clients into AGTP method invocations.

+--------------------+              +--------------------+
|  HTTP/REST Client  |  HTTP/1.1    |  HTTP Gateway      |
|  (non-AGTP-aware)  | -----------> |  (Sidecar)         |
+--------------------+              +--------------------+
                                              |
                                              | AGTP method
                                              | invocation
                                              v
                                    +--------------------+
                                    |  AGTP Daemon       |
                                    |  (port 4480)       |
                                    +--------------------+
Figure 2: HTTP Gateway Translation Pattern

10.2. Translation Rules

The gateway applies the following translation rules:

  1. HTTP method to AGTP method. The HTTP method is run through the server's policies.methods.aliases map per [AGTP-API]; the resolved canonical AGTP method is used for dispatch. The default alias seed (GET to FETCH, POST to CREATE, PUT to REPLACE, DELETE to REMOVE, PATCH to MODIFY) handles the five common verbs. The original HTTP method is preserved on the Attribution-Record as requested_method per [AGTP-IDENTIFIERS].

  2. HTTP path to AGTP path. The path is forwarded verbatim, subject to the path grammar in [AGTP-API].

  3. HTTP headers to AGTP headers. The gateway MAY forward selected headers (e.g., Authorization mapped to AGTP authentication context per the External IdP composition profile in Section 9); the specific header forwarding policy is operator-defined.

  4. Response. The AGTP response (status, headers, body) is translated into an HTTP response. The gateway MUST invoke the standard response-finalization path so the AGTP response carries a valid Attribution-Record; the resulting Audit-ID and Server-ID participate in the same per-agent chain as native AGTP responses.

10.3. Constraints

  • The gateway **MUST strip the Allow-RCNS header from inbound HTTP requests before dispatch.** HTTP callers cannot opt into Runtime Contract Negotiation Substrate through the gateway by design; RCNS is a substrate feature for AGTP-native callers whose identity, trust tier, and scope are bound at the AGTP layer. Operators that want to expose RCNS to HTTP callers MUST layer AGTP-native authentication on top of the gateway, in which case the gateway is no longer the right abstraction.

  • The gateway is a translation surface, not a transport protocol. Two AGTP servers exchanging traffic with one another MUST NOT use the gateway as their hop; AGTP is its own transport, and gateway-mediated AGTP-to-AGTP flows would lose the wire-level identity, attribution, and trust-posture guarantees this specification defines.

  • The gateway **MUST NOT synthesize AGTP identity headers from HTTP request properties.** The Agent-ID and Owner-ID forwarded to the AGTP daemon MUST identify the gateway's own agent identity (the agent on whose behalf the gateway is calling into the AGTP layer), not an identity inferred from the HTTP client. HTTP clients that need authenticated agent identity at the AGTP layer MUST present credentials the gateway can validate and lift into a Pattern 2 External IdP composition.

10.4. Reference Deployment Pattern

The reference implementation pattern is an operational module distributed as mod_http_gateway or equivalent, listening on a separate port from the AGTP listener (default 127.0.0.1:8080 for the gateway, port 4480 for AGTP), so the two protocols never share a socket.

10.5. Wire Example: HTTP GET Translated to AGTP FETCH

GET /agents/library/books/2026-spring HTTP/1.1
Host: library.example.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

The gateway translates this to:

AGTP/1.0 FETCH
Agent-ID: agtp://gateway.library.example.com/agents/http-bridge
Owner-ID: owner:library.example.com
Authority-Scope: catalog:read
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Session-ID: sess-http-bridge-9f3a
Task-ID: task-http-001
Content-Type: application/agtp+json

{
  "method": "FETCH",
  "task_id": "task-http-001",
  "parameters": {
    "path": "/agents/library/books/2026-spring",
    "format": "structured"
  }
}

The Agent-ID is the gateway's own agent identity, not synthesized from the HTTP client. The bearer token from the HTTP request is forwarded and validated by the AGTP server's External IdP composition per Pattern 2. The original HTTP method (GET) is preserved on the Attribution-Record as requested_method for audit reconstruction.

11. Cross-Composition Interoperability

This section addresses interoperability concerns that arise when multiple composition families are active simultaneously: an agent serving MCP and A2A workflows on the same session, a Pattern 2 IdP composition combined with an HTTP gateway, or a cross-AGMP delegation chain that traverses an external IdP boundary.

11.1. Agent Discovery Across AGMPs

An agent registered with an AGTP governance platform is discoverable regardless of which AGMP it uses. The AGTP Agent Manifest Document exposes the agent's supported methods and modalities; the AGTP DESCRIBE method exposes its capabilities. AGMP-specific capability formats (A2A Agent Cards, MCP capability lists) MAY be included as extensions to the AGTP Capability Document but are not required.

11.2. Session Continuity Across AGMPs

A single AGTP session MAY carry messages from multiple AGMPs within the same workflow. For example, an orchestrator agent might use A2A to delegate a task, then use MCP to invoke a tool within that task, all within a single AGTP session identified by the same Session-ID. AGTP session semantics persist across AGMP message types within the session.

11.3. Identity Consistency Across Composition Families

An agent operating across multiple composition families MUST use the same canonical AGTP Agent-ID in all AGTP headers, regardless of which adjacent layer is composed. AGMP-layer identity fields (A2A agent.id, MCP client_id), external IdP claims, and HTTP-client identifiers MAY differ from the canonical AGTP Agent-ID for backward compatibility with non-AGTP deployments, but the AGTP Agent-ID is authoritative for all governance and audit purposes.

11.4. IdP and Gateway Combined

An HTTP request with a Bearer token arriving at an HTTP gateway composes both the External IdP profile and the HTTP Gateway profile:

  1. The gateway translates the HTTP request to an AGTP method invocation per Section 10, forwarding the Authorization header.

  2. The AGTP server validates the bearer token per the External IdP composition Pattern 2 in Section 9, lifting the configured claim as principal_id.

  3. The Attribution-Record carries both the gateway's Agent-ID (which agent invoked the method) and the lifted principal_id (on whose behalf the call was made).

The gateway is the agent at the AGTP layer; the bearer token's subject is the principal. Both compose cleanly into the existing two-axis model.

12. Security Considerations

12.1. AGMP Payload Injection

Threat: A malicious actor embeds forged identity or scope fields in an AGMP message payload, attempting to override or supplement the AGTP header values with elevated permissions.

Mitigation: Infrastructure components MUST NOT parse AGMP payloads for identity or scope information. The precedence rule in Section 4 is absolute: AGTP headers govern all infrastructure decisions. Application code SHOULD validate that AGMP payload identity fields are consistent with the AGTP headers and MUST reject requests where they conflict in ways that suggest an escalation attempt.

12.2. Cross-AGMP Delegation Elevation

Threat: An agent uses AGMP composition to cross protocol boundaries in a way that circumvents AGTP scope enforcement. For example, receiving a task via A2A with a delegated scope, then re-delegating it via MCP with an elevated scope.

Mitigation: The AGTP Delegation-Chain header MUST be maintained across AGMP boundaries. Each re-delegation MUST result in a new AGTP DELEGATE invocation with a scope that is a strict subset of the delegating agent's Authority-Scope. Scope MUST NOT increase across AGMP composition boundaries.

12.3. Payload Schema Validation

Implementers SHOULD use the AGTP Content-Schema header to declare the schema of the AGMP payload. Recipients SHOULD validate the payload against the declared schema before processing. This mitigates injection attacks that rely on schema ambiguity at the AGMP layer.

12.4. Bearer Token Leakage via Attribution-Record

Threat: An implementation incorrectly stamps the raw Authorization header value or the raw bearer token onto the Attribution-Record. Since Attribution-Records are signed and may be replayed by chain walkers and audit consumers, this would create a credential-disclosure surface.

Mitigation: AGTP MUST NOT stamp the raw Authorization header value or the raw token onto the Attribution-Record. Only the validated, lifted claim (the principal_id) appears on the Attribution-Record per [AGTP-IDENTIFIERS]. Implementations MUST verify this constraint in their attribution-record builder before release.

12.5. External IdP Validator Confusion

Threat: A server with multiple configured IdP validators dispatches a credential to the wrong validator, causing a credential issued by one IdP to be interpreted as if issued by another. An attacker could exploit this to present a credential to a validator that accepts it when the intended validator would have rejected it.

Mitigation: Servers MUST route credentials to the correct validator based on policy-defined matching rules (token issuer, audience claim, header marker). Servers MUST NOT dispatch a credential to multiple validators in parallel and accept any success; this creates the confusion surface described above.

12.6. HTTP Gateway Identity Synthesis

Threat: An HTTP gateway implementation synthesizes AGTP identity headers from HTTP request properties (client IP, user-agent string, hostname), creating a forgeable identity surface.

Mitigation: The gateway MUST NOT synthesize Agent-ID or Owner-ID from HTTP request properties per the constraints in Section 10. The Agent-ID forwarded to the AGTP daemon MUST identify the gateway's own agent identity. HTTP clients that need authenticated agent identity at the AGTP layer MUST present credentials the gateway can validate and lift into a Pattern 2 External IdP composition.

12.7. HTTP Gateway RCNS Bypass

Threat: An HTTP client attempts to opt into Runtime Contract Negotiation Substrate (RCNS) through the gateway by sending an Allow-RCNS header, gaining access to a substrate feature that is designed for AGTP-native callers with bound identity, trust tier, and scope.

Mitigation: The gateway MUST strip the Allow-RCNS header from inbound HTTP requests before dispatch per Section 10. Operators that want to expose RCNS to HTTP-originating callers MUST layer AGTP-native authentication on top of the gateway, in which case the gateway is no longer the right abstraction.

13. IANA Considerations

This document defines no new IANA registrations. All AGTP method, header, and status code registrations are defined in [AGTP]. External identity providers retain their own registrations ([RFC6749], [RFC6750]). AGMP specifications retain their own registrations. The Content-Schema URIs used in this document reference external schema registries maintained by the respective adjacent-layer specification bodies.

14. Changes from v00

Version 01 broadens the document's scope from AGMP-only composition to a three-family composition profile structure. The AGMP profiles are updated to track the v08 AGTP method floor and renamed identifiers. Two new composition profile families are introduced: External Identity Provider composition and HTTP Gateway composition. These were previously specified in the v08 base spec's "Composition with Higher-Level Frameworks" section; v01 of this document is the canonical location for the normative specification.

14.1. Substantive Changes

  1. Title expanded to "AGTP Composition Profiles: Agent Group Messaging Protocols, External Identity Providers, and HTTP Gateways" reflecting the broader scope.

  2. External Identity Provider composition profile added as Section 9. Three composition patterns (AGTP-only, AGTP+IdP, OIDC-federated Genesis trust). Authorization header semantics. Token opacity rule. 401 reason vocabulary (oauth-required, oauth-invalid). Backward compatibility guidance. Wire example showing OIDC bearer token composition.

  3. HTTP Gateway composition profile added as Section 10. Architectural position. Translation rules (HTTP method to AGTP method via alias map; HTTP path verbatim; header forwarding policy; response finalization). Constraints (Allow-RCNS header stripping; transport-vs-translation distinction; no identity synthesis from HTTP properties). Reference deployment pattern. Wire example showing HTTP GET translated to AGTP FETCH.

  4. Cross-AGMP Interoperability renamed and broadened to Cross-Composition Interoperability. New subsection covering the combined IdP-plus-Gateway case.

  5. Identifier rename applied throughout. The Principal-ID wire header is renamed to Owner-ID in all AGMP mapping tables, mapping rules, and wire examples, tracking the locked AGTP taxonomy from [AGTP-IDENTIFIERS].

  6. Security Considerations expanded to cover the new profile families. Four new subsections: Bearer Token Leakage via Attribution-Record; External IdP Validator Confusion; HTTP Gateway Identity Synthesis; HTTP Gateway RCNS Bypass.

  7. Normative reference to [AGTP] updated to v08 (was v02 in v00).

  8. Informative references added to [AGTP-API], [AGTP-IDENTIFIERS], [AGTP-TRUST], [AGTP-LOG], [AGTP-PRESENCE], [AGTP-LEI], [AGTP-COMMERCE], and [AGTP-DISCOVERY], reflecting the broader AGTP draft family that has emerged since v00 of this document.

  9. Normative reference to [RFC9110] added to support the Authorization header semantics in the External IdP composition profile. Informative references to [RFC6749] (OAuth 2.0) and [RFC6750] (Bearer tokens) added.

  10. Method floor references updated. Where v00 referenced the 12-method or 16-method floor, v01 references the current 18-method floor per [AGTP].

14.2. Composition Profile Boundary Clarifications

This document covers three composition profile families. Other composition surfaces specific to AGTP companion specifications are addressed in those specifications and are not duplicated here:

  • Payment provider composition is specified in [AGTP-COMMERCE].

  • Credit bureau and trust provider composition is specified in [AGTP-TRUST].

  • Certificate authority composition is specified in [AGTP-CERT].

  • Institutional identity composition (LEI/vLEI) is specified in [AGTP-LEI].

14.3. Wire Format Compatibility

The v01 changes are additive (new profile families, expanded security considerations, broader scope) and identifier-alignment (Principal-ID to Owner-ID rename). No AGMP composition wire format changes are introduced beyond the identifier rename that tracks the broader AGTP taxonomy update. Implementations conforming to v00 require the Owner-ID rename to interoperate with v01 implementations and AGTP v08 servers.

15. References

15.1. Normative References

[AGTP]
Hood, C., "Agent Transfer Protocol (AGTP)", Work in Progress, Internet-Draft, draft-hood-independent-agtp-09, , <https://datatracker.ietf.org/doc/html/draft-hood-independent-agtp-09>.
[RFC2119]
Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, , <https://www.rfc-editor.org/rfc/rfc2119>.
[RFC8174]
Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, , <https://www.rfc-editor.org/rfc/rfc8174>.
[RFC9110]
Fielding, R., Ed., Nottingham, M., Ed., and J. Reschke, Ed., "HTTP Semantics", STD 97, RFC 9110, DOI 10.17487/RFC9110, , <https://www.rfc-editor.org/rfc/rfc9110>.

15.2. Informative References

[A2A]
Linux Foundation, "Agent-to-Agent Protocol Specification", , <https://a2aprotocol.ai>.
[ACP]
IBM Research, "Agent Communication Protocol", .
[AGTP-API]
Hood, C., "AGTP-API: Verbs, Paths, Endpoints, and Synthesis", Work in Progress, Internet-Draft, draft-hood-agtp-api-01, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-api-01>.
[AGTP-CERT]
Hood, C., "AGTP Agent Certificate Extension", Work in Progress, Internet-Draft, draft-hood-agtp-agent-cert-03, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-agent-cert-03>.
[AGTP-COMMERCE]
Hood, C., "AGTP-Commerce: Open Commerce Specification for Agent-to-Agent Transactions", Work in Progress, Internet-Draft, draft-hood-agtp-commerce-00, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-commerce-00>.
[AGTP-DISCOVERY]
Hood, C., "AGTP Discovery and Naming", Work in Progress, Internet-Draft, draft-hood-agtp-discovery-01, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-discovery-01>.
[AGTP-IDENTIFIERS]
Hood, C., "AGTP Identifier Chain", Work in Progress, Internet-Draft, draft-hood-agtp-identifiers-02, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-identifiers-02>.
[AGTP-LEI]
Hood, C., "AGTP-LEI: Binding the Agent Transfer Protocol to the Verifiable Legal Entity Identifier", Work in Progress, Internet-Draft, draft-hood-agtp-lei-00, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-lei-00>.
[AGTP-LOG]
Hood, C., "AGTP Transparency Log", Work in Progress, Internet-Draft, draft-hood-agtp-log-02, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-log-02>.
[AGTP-PRESENCE]
Hood, C., "AGTP Presence: Ambient Discovery and Visibility for Agent Substrates", Work in Progress, Internet-Draft, draft-hood-agtp-presence-00, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-presence-00>.
[AGTP-TRUST]
Hood, C., "AGTP Trust and Verification Specification", Work in Progress, Internet-Draft, draft-hood-agtp-trust-02, , <https://datatracker.ietf.org/doc/html/draft-hood-agtp-trust-02>.
[ANP]
"Agent Network Protocol", .
[MCP]
Anthropic, "Model Context Protocol", , <https://modelcontextprotocol.io>.
[RFC6749]
Hardt, D., Ed., "The OAuth 2.0 Authorization Framework", RFC 6749, DOI 10.17487/RFC6749, , <https://www.rfc-editor.org/rfc/rfc6749>.
[RFC6750]
Jones, M. and D. Hardt, "The OAuth 2.0 Authorization Framework: Bearer Token Usage", RFC 6750, DOI 10.17487/RFC6750, , <https://www.rfc-editor.org/rfc/rfc6750>.

Appendix A. Acknowledgments

The AGMP composition profiles in this document build on the foundational work of the MCP, A2A, and ACP specification teams. AGTP is designed to be additive to and compatible with their work, not competitive with it. Thank you to Anthropic, Linux Foundation A2A team, and IBM ACP.

The External Identity Provider composition profile builds on the foundational work of the OAuth and OIDC communities. The composition treats AGTP identity and external IdP credentials as orthogonal axes that compose cleanly without modification to either.

The HTTP Gateway composition profile addresses the practical reality that many existing clients communicate over HTTP. The translation contract specified here makes the adoption ramp interoperable across implementations without requiring HTTP to be modified.

Author's Address

Chris Hood
Nomotic, Inc.