Home/AI Agents/agent-protocol
agent-protocol logo

agent-protocol

agi-inc/agent-protocol

Common interface for AI agents

GraphCanon updated 2w · GitHub synced 2w

1.5k stars185 forksLast push 1y Python MIT

Decision brief

agent-protocol provides a standardized interface for interacting with various AI agents regardless of their underlying tech stack, aiming to ease development, deployment, and benchmarking.

Good fit when

  • When you want to ensure interoperability between different AI agents irrespective of the frameworks used by them.
  • To facilitate easier integration of your AI agent into a broader ecosystem that supports the Agent Protocol for seamless communication.

Avoid when

  • If you are developing an isolated system with no intention to communicate or integrate with other AI agents outside this scope.
  • When working in environments where specific, proprietary interfaces provide significantly better performance or features than adhering to a generic protocol could offer.

Observed Jul 16, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Dormant (484d since push)
As of 2w
Provenance
Not a fork · Organization account
As of 2w
Security (OSV)
35 low (35 low)
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install agent-protocol
PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Provides a standardized protocol enabling interaction with any AI agent, regardless of underlying tech stack.

Capability facts

MCP server
No MCP server detected

Source: repo_scan · Aug 6, 2026

Languages
python, javascript, typescript

Source: github.language+package.json · Aug 6, 2026

Categories

Tags

README

Badge image Badge image

Maintained by AGI, Inc.

📚 Docs

You can find more info in the docs.

🧾 Summary

The AI agent space is young. Most developers are building agents in their own way. This creates a challenge: It's hard to communicate with different agents since the interface is often different every time. Because we struggle with communicating with different agents, it's also hard to compare them easily. Additionally, if we had a single communication interface with agents, it'd also make it easier developing devtools that works with agents out of the box.

We present the Agent Protocol - a single common interface for communicating with agents. Any agent developer can implement this protocol. The Agent Protocol is an API specification - list of endpoints, which the agent should expose with predefined response models. The protocol is tech stack agnostic. Any agent can adopt this protocol no matter what framework they're using (or not using).

We believe, this will help the ecosystem grow faster and simplify the integrations.

We're starting with a minimal core. We want to build upon that iteratively by learning from agent developers about what they actually need.

🚀 The incentives to adopt the protocol

  • Ease with which you can use the benchmarks.
  • Other people can more easily use and integrate your agent
  • Enable building general devtools (for development, deployment and monitoring) that can be built on top of this protocol
  • You don’t need to write boilerplate API and you can focus on developing your agent

🎯 Immediate goals of the protocol

Set a general simple standard that would allow for easy to use benchmarking of agents. One of the primary goals of the protocol is great developer experience, and simple implementation on the end of agent developers. You just start your agent and that’s all you have to do.

🗣️ Request for Comments

If you'd like to propose a change or an improvement to the protocol. Please follow the RFC template.

⚙️ Components

Protocol

The most important part. It specifies which endpoints should the agent expose. The protocol is defined in OpenAPI specification.

How does the protocol work?

Right now the protocol is defined as a REST API (via the OpenAPI spec) with two essential routes for interaction with your agent:

  • POST /ap/v1/agent/tasks for creating a new task for the agent (for example giving the agent an objective that you want to accomplish)
  • POST /ap/v1/agent/tasks/{task_id}/steps for executing one step of the defined task

It has also a few additional routes for listing the tasks, steps and downloading / uploading artifacts.

SDK

This is our implementation of the protocol. It’s a library that you can use to build your agent. You can use it, or you can implement it on your own. It’s up to you.

Using the SDK should simplify the implementation of the protocol to the bare minimum, but at the same time it shouldn't tie your hands. The goal should be to allow agent builders to build their agents and the SDK should solve the rest.

Basically it wraps your agent in a web server that allows for communication with your agent (and in between agents in the future).

Client

This library should be u

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.