Open Agent Protocol

Agent Interoperability.
By Design.

The open standard for how agents discover each other, exchange events and commands, and observe what happened — across distributed systems.

Read the docs View on GitHub
✓ JSON Schema canonical format ✓ REST, MCP, A2A transports ✓ /.well-known/oap discovery

Capabilities

Built for agent interoperability

OAP defines composable capabilities that any agent can expose and any consumer can discover — over REST, MCP, or A2A.

📋

Agent Registry

Register, discover, and manage agents with a standard descriptor format.

⚡

Event Delivery

Send immutable events to agents. The runtime routes them asynchronously.

🎯

Command Log

Observe commands produced by agents — intents to change the system.

🔍

Execution Traces

Full observability: what event went in, what commands came out, how long it took.

🌐

Discovery

/.well-known/oap — any consumer hits one URL and learns everything.

🔌

Transport Agnostic

REST for web UIs, MCP for LLMs, A2A for agent-to-agent coordination.

See it in action

Discovery manifest

Every OAP endpoint exposes a /.well-known/oap manifest. Consumers discover agents, capabilities, and transports in a single request.

/.well-known/oap
{
  "oap": {
    "version": "2025-07-01",
    "services": {
      "io.oap.agents": {
        "version": "2025-07-01",
        "description": "Agent management, event delivery, command observation",
        "rest": {
          "schema": "https://openagentprotocol.io/v1/services/agents/openapi.json",
          "endpoint": "https://api.example.com/"
        }
      }
    },
    "capabilities": [
      {
        "name": "io.oap.agents.registry",
        "version": "2025-07-01",
        "description": "Register, remove, list agents",
        "spec": "https://openagentprotocol.io/specs/agents/registry",
        "schema": "https://openagentprotocol.io/v1/schemas/agents/registry.json"
      }
    ],
    "agents": [
      {
        "id": "negotiation",
        "name": "Contract Negotiation",
        "accepts": ["ContractProposed"],
        "produces": ["ProposeCounter", "AcceptContract"],
        "status": "running"
      }
    ]
  }
}

Designed for everyone

Who is OAP for?

For Developers

Build the next generation of agents on an open foundation. JSON Schema definitions, OpenAPI specs, and transport bindings — everything you need to implement OAP.

For Businesses

Expose your services to any agent in the world. No bespoke integrations — just a manifest describing what you accept and produce.

For AI Platforms

Discover and interact with any OAP-compliant agent using MCP, A2A, or simple REST. Compatible with existing agent frameworks.

For IoT & Sensors

Even a temperature sensor can be an OAP agent — it produces events, exposes a descriptor, and any consumer can discover it.

Get started today

OAP is open-source under Apache 2.0. Explore the spec, read the schemas, and start building.

Read the docs View on GitHub