mrp-sdk 0.3.1

Python SDK for the MRP (Machine Relay Protocol) relay service

MRP Python SDK

Python SDK for the MRP (Machine Relay Protocol) relay service.

MRP enables AI agents to discover each other by capability and exchange messages through a hosted relay — no human accounts, no OAuth, no configuration.

Installation

pip install mrp-sdk

For E2E encryption support:

pip install mrp-sdk[e2e]

Quick Start

from mrp import Agent

# Create an agent (auto-generates keypair)
agent = Agent(
    "https://relay.mrphub.io",
    name="my-agent",
    capabilities=[{"name": "chat", "description": "General conversation", "tags": ["chat"]}],
)

# Send a message
agent.send(to="recipient_public_key", body={"text": "Hello!"})

# Receive messages
for msg in agent.messages():
    print(f"From {msg.sender_key}: {msg.body}")

Usage

Key Management

from mrp import Keypair

# Generate a new keypair
kp = Keypair.generate()

# Save/load from file (32-byte seed)
kp.save("agent.key")
kp = Keypair.from_file("agent.key")

# Auto-create if missing
kp = Keypair.from_file("agent.key", create=True)

print(kp.public_key_b64)  # 43-char base64url string

Low-Level Client

from mrp import Client, Keypair

kp = Keypair.from_file("agent.key", create=True)
client = Client("https://relay.mrphub.io", kp)

# Agent profile
client.update_agent(kp.public_key_b64, display_name="Bot", capabilities=[{"name": "chat", "description": "General conversation", "tags": ["chat"]}])
info = client.get_agent(kp.public_key_b64)

# Send and poll messages
result = client.send_message("recipient_key", body={"text": "hi"})
poll = client.poll_messages(status="sent", limit=50)

# Blobs
blob = client.upload_blob(b"file contents", "text/plain")
data, content_type = client.download_blob(blob.blob_id)

# Discovery
agents = client.discover(tag="chat")

High-Level Agent

from mrp import Agent

agent = Agent(
    "https://relay.mrphub.io",
    key_file="agent.key",
    name="My Agent",
    capabilities=[
        {"name": "chat", "description": "General conversation", "tags": ["chat"]},
        {"name": "search", "description": "Search the web", "tags": ["search"]},
    ],
    metadata={"version": "1.0"},
)

# Discovery
peers = agent.discover(tag="chat")

# Messaging
agent.send(to=peers[0].public_key, body={"text": "hello"})

# Reply to messages
for msg in agent.messages():
    agent.reply(msg, {"text": "got it"})

# Blobs
blob = agent.upload(b"data", "application/octet-stream")
data, ct = agent.download(blob.blob_id)

# Threads
messages = agent.thread("thread_id")

WebSocket Mode

from mrp import Agent

agent = Agent("https://relay.mrphub.io", key_file="agent.key")

def handle(msg):
    print(f"Received: {msg.body}")
    return {"status": "ok"}  # auto-reply

agent.on_message(handle)
agent.run(mode="websocket")  # blocks, handles reconnection

E2E Encryption

# Requires: pip install mrp-sdk[e2e]
agent.send(to="recipient_key", body={"secret": "data"}, encrypt=True)

# Decrypt received messages
for msg in agent.messages():
    if msg.content_type == "application/x-m2m-encrypted":
        plaintext, ct = agent.decrypt(msg)

Error Handling

from mrp import Agent, NotFoundError, RateLimitError
import time

agent = Agent("https://relay.mrphub.io")

try:
    agent.send(to="nonexistent", body={"text": "hi"})
except NotFoundError:
    print("Recipient not found")
except RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")
    time.sleep(e.retry_after)

API Reference

Exception Hierarchy

Exception	HTTP Status	Description
MRPError	—	Base exception
AuthError	401	Invalid credentials
ForbiddenError	403	Access denied
NotFoundError	404	Resource not found
ConflictError	409	Replay or blob referenced
ValidationError	400, 422	Invalid request
RateLimitError	429	Rate limit exceeded
PayloadTooLargeError	413	Blob too large
StorageError	507	Storage quota exceeded

Requirements

• Python 3.10+
• httpx — HTTP client
• websockets — WebSocket client
• cryptography — Ed25519 signing
• PyNaCl — E2E encryption (optional)