Interoperability

EEP is designed to co-exist and interoperate with the Model Context Protocol (MCP), A2A, OpenAPI, ActivityPub, AT Protocol, and existing enterprise API gateways. EEP fills the identity + event buslayer that established protocols need but don't provide.

EEP and MCP

MCP defines the agent-to-tool layer — how an LLM accesses tools, resources, and prompts from a server. EEP operates at the entity-to-agent network layer — how entities publish state and control access. The two protocols are complementary, not competing.

AspectMCPEEP
LayerAgent-to-toolEntity-to-agent (network)
DiscoveryTool list from server/.well-known/eep.json
AuthenticationNo native DID authDID-based cryptographic identity
PaymentsNot supportedx402 + on-chain proofs
Real-time eventsNot nativeLayer 2 SSE + Webhooks
Bilateral negotiationNot nativeLayer 3 WebSockets + commerce state machine

Example: An agent uses MCP for local web-search and code-runnertools, and uses EEP to subscribe to a financial data publisher's real-time price feed — paying via x402 and verifying the publisher's EEP Conformance Credential.

EEP and OpenAPI

OpenAPI documents what an endpoint does for human developers. EEP documents how agents discover, authenticate, and access the entity. An entity can be fully OpenAPI-documented and EEP-compliant simultaneously.

AspectOpenAPIEEP
AudienceHuman developersAutonomous agents
Access controlAPI keys / OAuthDID proofs, VCs, payments (machine-resolved)
EventsNot nativeLayer 2 SSE + Webhooks

EEP and ActivityPub / AT Protocol

ActivityPub (Mastodon) and AT Protocol (Bluesky) are human-centric social communication protocols. EEP is agent-centric. Publishers can expose EEP endpoints alongside their existing feeds — their content becomes available to agents in structured form without abandoning their social presence.

CapabilityActivityPubAT ProtocolEEP
Machine-readable structured dataPartialPartial✅ TOON/JSON/Markdown
Real-time event streamExternal (WebSub)Firehose✅ Native SSE
DID-based identity✅ (PLC)✅ W3C DIDs
Gated access (payment, credential)
Autonomous commerce✅ Layer 3 WS

EEP and Enterprise API Gateways

Organizations running Kong, Apigee, or AWS API Gateway do not need to replace them. EEP can be implemented as a thin middleware that wraps existing infrastructure. A company with an existing API can become EEP Core-conformant in a single sprint.

The minimal EEP compatibility layer must:

  1. Expose /.well-known/eep.json at the gateway root
  2. Add Link: <...>; rel="eep" response headers
  3. Validate EEP gate proofs before forwarding requests
  4. Transform backend events to CloudEvents format for SSE/Webhook delivery
yaml
# Kong Gateway — add EEP Link headers
plugins:
- name: response-transformer
config:
add:
headers:
- "Link: <https://api.example/.well-known/eep.json>; rel=\"eep\""
- "Link: <https://api.example/eep/subscribe>; rel=\"subscribe\""

Next steps