Interoperability Guide

Implementation guidance for integrating Agent Data Pods with other AI agent protocols and discovery mechanisms.

Protocol Compatibility Matrix

Protocol compatibility levels and integration points
Protocol	Support Level	Integration Points
Solid Protocol	Native	Full compliance as Solid Pod profile
Agent Network Protocol (ANP)	Full	did:wba identity, Agent Description
Agent2Agent (A2A)	Compatible	Agent Card at `/.well-known/agent.json`
Model Context Protocol (MCP)	Full	`agent:mcpEndpoint` for tool invocation
OpenMemory HMD v2	Partial	Memory sector taxonomy alignment

ANP Integration

did:wba Identity

Agent Data Pods can use the did:wba method for cross-platform agent identity.

Pod Profile Integration

Turtle

@prefix schema: <https://schema.org/> .
@prefix agent: <https://awkronos.github.io/web/vocab#> .
@prefix solid: <http://www.w3.org/ns/solid/terms#> .

<#me>
    schema:identifier <did:wba:example.com:user:agent-001> ;
    solid:service [
        a agent:AgentDescriptionService ;
        solid:endpoint </public/agent/ad.json>
    ] .

DID Document Hosting

The Pod MAY host the DID Document at /.well-known/did.json:

JSON

{
  "@context": "https://www.w3.org/ns/did/v1",
  "id": "did:wba:example.com:user:agent-001",
  "verificationMethod": [{
    "id": "did:wba:example.com:user:agent-001#key-1",
    "type": "EcdsaSecp256k1VerificationKey2019",
    "controller": "did:wba:example.com:user:agent-001",
    "publicKeyMultibase": "zQ3shokFTS..."
  }],
  "authentication": ["did:wba:example.com:user:agent-001#key-1"],
  "keyAgreement": [{
    "id": "did:wba:example.com:user:agent-001#key-agreement-1",
    "type": "X25519KeyAgreementKey2020",
    "controller": "did:wba:example.com:user:agent-001",
    "publicKeyMultibase": "z6LSbysY7b..."
  }],
  "service": [{
    "id": "did:wba:example.com:user:agent-001#solid-pod",
    "type": "SolidStorageService",
    "serviceEndpoint": "https://example.com/user/"
  }]
}

ANP Agent Description

Provide an Agent Description document at /public/agent/ad.json:

JSON-LD

{
  "@context": [
    "https://schema.org",
    "https://agentnetworkprotocol.com/ns"
  ],
  "@type": "AgentDescription",
  "@id": "did:wba:example.com:user:agent-001",
  "name": "Personal Assistant",
  "description": "AI assistant for calendar and email management",
  "version": "1.0.0",
  "interfaces": [
    {
      "@type": "MCPInterface",
      "protocol": "https://modelcontextprotocol.io/specification/2025-11-25",
      "url": "wss://api.example.com/mcp/agent-001"
    }
  ],
  "capabilities": ["calendar:read", "calendar:write", "email:read", "email:send"],
  "solidProfile": "/profile/card#me"
}

A2A Integration

Agent Card

For A2A Protocol compatibility, serve an Agent Card at /.well-known/agent.json:

JSON

{
  "name": "Personal Assistant",
  "description": "AI assistant for calendar and email management",
  "url": "https://example.com/user/",
  "provider": {
    "organization": "Awkronos",
    "url": "https://awkronos.com"
  },
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true
  },
  "skills": [
    {
      "id": "calendar",
      "name": "Calendar Management",
      "description": "Read and write calendar events"
    },
    {
      "id": "email",
      "name": "Email Management",
      "description": "Send and receive email"
    }
  ],
  "authentication": {
    "schemes": ["oauth2", "solid-oidc"]
  }
}

MCP Integration

Endpoint Configuration

The agent:mcpEndpoint property in the Pod profile points to the MCP server:

Turtle

<#me>
    agent:mcpEndpoint <wss://api.example.com/mcp/agent-001> .

Capability Mapping

MCP tools map directly to Agent Data Pod capabilities:

Mapping between Agent Data Pod vocabulary and MCP concepts
Agent Data Pod	MCP
`agent:Capability`	Tool
`agent:name`	Tool name
`agent:description`	Tool description
`agent:requiredPermission`	N/A (use Solid ACLs)

Memory Interoperability

OpenMemory HMD v2 Alignment

Agent Data Pod memory sectors map to OpenMemory HMD v2 taxonomy:

Memory type mapping to OpenMemory HMD v2 taxonomy
`agent:memoryType`	HMD v2 Sector	Description
`episodic`	Episodic	Autobiographical events and experiences
`semantic`	Semantic	Facts, concepts, and general knowledge
`procedural`	Procedural	How-to knowledge and learned processes
`emotional`	Emotional	Affective context and sentiment
`reflective`	Reflective	Meta-cognitive observations

Embedding Interoperability

When sharing embeddings across systems:

Document the model: Always set agent:embeddingModel
Use consistent dimensions: Verify agent:embeddingDim matches expected values
Specify chunking: Set agent:chunkingStrategy for reproducibility

Discovery Flow

Recommended Discovery Sequence

Check /.well-known/agent.json for A2A compatibility
Resolve DID if did:wba is present in profile
Fetch Agent Description from AgentDescriptionService endpoint
Read Solid profile at /profile/card for full RDF metadata
Fetch capabilities from agent:capabilities link

Error Response Codes

HTTP response codes and recommended actions
HTTP Status	Meaning	Action
200	Success	Parse response
404	Not found	Skip optional resource, fail on required
401/403	Unauthorized	Authenticate and retry
408	Timeout	Retry with backoff
429	Rate limited	Wait and retry
5xx	Server error	Retry with backoff

Security Considerations

Cross-Protocol Authentication

Solid-OIDC: Use for Solid Pod access
DPoP tokens: Recommended for all authenticated requests
did:wba verification: Verify DID Document signatures for cross-platform trust

Signature Verification

When verifying signatures across protocols:

Canonicalize RDF using RDFC-1.0 algorithm
Serialize as N-Quads
Verify using the key type specified in the DID Document

Supported verification key types:

Ed25519VerificationKey2020 (RECOMMENDED)
EcdsaSecp256k1VerificationKey2019 (MUST for did:wba)
JsonWebKey2020 (MAY)

References

[AGENT-DATA-POD]: Agent Data Pod Specification. spec.html
[DID-WBA]: ANP did:wba Method. https://agentnetworkprotocol.com/en/specs/03-did-wba-method-specification/
[ANP-AGENT-DESCRIPTION]: ANP Agent Description Protocol. https://agentnetworkprotocol.com/en/specs/07-anp-agent-description-protocol-specification/
[A2A-PROTOCOL]: A2A Protocol Specification. https://a2a-protocol.org/latest/specification/
[MCP]: Model Context Protocol. https://modelcontextprotocol.io/specification/latest
[SOLID-PROTOCOL]: Solid Protocol. https://solidproject.org/TR/protocol
[RDFC-1.0]: W3C RDF Dataset Canonicalization. https://w3c.github.io/rdf-canon/spec/

Part of the Agent Data Pod Specification