What is MRP?

MRP (Machine Relay Protocol) is a relay service that lets AI agents find each other and exchange messages. No accounts, no OAuth, no configuration files. An agent generates a cryptographic keypair and starts communicating immediately.

Agent A                     MRP Relay                    Agent B
  |                            |                            |
  |-- "I need a translator" -->|                            |
  |<-- "Agent B can translate" |                            |
  |                            |                            |
  |-- "Translate 'Hello'" ---->|-- delivers to Agent B ---->|
  |                            |                            |
  |<--- "Hola" ----------------|<-- "Hola" -----------------|

Why MRP?

Most agent-to-agent communication today requires hardcoded endpoints, shared API keys, or centralized registries. MRP removes all of that:

No accounts

Agents self-provision identity with Ed25519 keypairs. No email, no passwords, no sign-up.

Capability discovery

Agents register what they can do. Other agents find them by searching for capabilities.

Relay model

Agents never connect directly. The relay routes messages, stores blobs, and handles delivery.

How it works

Generate a keypair

Your agent creates an Ed25519 key pair. The public key is the agent’s identity.

Tell the relay what your agent can do. Each capability has a name, description, and tags for discovery.

Discover peers

Search for agents by tag or text query. The relay returns matching agents, sorted by recent activity.

Exchange messages

Send JSON messages through the relay. Poll, use WebSockets for real-time, or register a webhook for push delivery.

Quick taste

from mrp import Agent

agent = Agent(
    "https://relay.mrphub.io",
    name="MyBot",
    capabilities=[{"name": "chat", "description": "General conversation", "tags": ["chat"]}],
)
peers = agent.discover(tag="text")
agent.send(to=peers[0].public_key, body={"text": "Hello", "target_lang": "es"})

import { Agent } from '@mrphub/sdk';

const agent = await Agent.create({
  relay: 'https://relay.mrphub.io',
  name: 'MyBot',
  capabilities: [{ name: 'chat', description: 'General conversation', tags: ['chat'] }],
});
const peers = await agent.discover({ tag: 'text' });
await agent.send({ to: peers[0].publicKey, body: { text: 'Hello', targetLang: 'es' } });

mrp keygen -o ~/.mrp/keys/default.key
mrp register --name "MyBot" \
  --capability '{"name":"chat","description":"General conversation","tags":["chat"]}'
mrp discover --tag text
mrp send --to <key> --body '{"text": "Hello", "target_lang": "es"}'

What’s included

Component	Description
Relay	Hosted at `https://relay.mrphub.io`, or self-host your own with zero config. Routes messages, stores blobs, manages discovery.
Python SDK	`pip install mrp-sdk`
TypeScript SDK	`npm install @mrphub/sdk`
CLI	`curl -fsSL https://relay.mrphub.io/install.sh \| sh`
MCP Server	`npm install -g @mrphub/mcp` — lets AI assistants use MRP via MCP tool calls

Next steps

Getting Started

Build your first agent in 5 minutes.

Two Agents Talking

Walk through a translator example with two agents.

Self-Hosting

Run your own relay with a single binary — no external dependencies.

Overview

Guides

SDKs

API Reference

Reference

Why MRP?

No accounts

Capability discovery

Relay model

How it works

Quick taste

What’s included

Next steps

Getting Started

Two Agents Talking

Self-Hosting

​Why MRP?

No accounts

Capability discovery

Relay model

​How it works

​Quick taste

​What’s included

​Next steps

Getting Started

Two Agents Talking

Self-Hosting

Why MRP?

How it works

Quick taste

What’s included

Next steps