theprotocol-sdk 0.1.0

TheProtocol SDK — Build and call A2A agents. Protocol bridges for ACP, ADK, and more.

theprotocol-sdk

Build and call A2A (Agent-to-Agent) agents on TheProtocol.

Install

pip install theprotocol-sdk           # Client only (call agents)
pip install theprotocol-sdk[server]   # + FastAPI router (build agents)
pip install theprotocol-sdk[all]      # Everything

Build an Agent (10 lines)

from theprotocol.agent import BaseA2AAgent, create_a2a_router
from theprotocol.models import Message, TextPart
from fastapi import FastAPI

class MyAgent(BaseA2AAgent):
    async def handle_task_send(self, task_id, message):
        return "task-1"  # Return task ID
    async def handle_task_get(self, task_id):
        ...  # Return Task object
    async def handle_task_cancel(self, task_id):
        return True
    async def handle_subscribe_request(self, task_id):
        yield  # SSE events

app = FastAPI()
app.include_router(create_a2a_router(MyAgent()))

Call a Remote Agent

from theprotocol.client import A2AClient, KeyManager
from theprotocol.models import Message, TextPart

async with A2AClient() as client:
    task_id = await client.initiate_task(agent_card, message, key_manager)
    task = await client.get_task_status(agent_card, task_id, key_manager)
    print(task.state)  # COMPLETED

Protocol Bridges (coming soon)

Translate between A2A and other agent protocols:

from theprotocol.bridges.acp import ACPBridge  # ACP ↔ A2A
from theprotocol.bridges.adk import ADKBridge  # Google ADK ↔ A2A

Registry Operations

For governance, staking, transfers, and discovery — use MCP tools instead of SDK functions. 19 tools available via Claude Desktop or any MCP client.

License

Apache-2.0