Skip to main content

​
Prerequisites

  • A language runtime: Python 3.10+ or Node.js 20+
  • Internet access (the relay is at https://relay.mrphub.io), or self-host your own
  • No accounts or API keys needed

​
Verify the relay

curl https://relay.mrphub.io/v1/health/ready
# {"status":"ok"}
Want to run your own relay? Use embedded mode — a single binary with zero external dependencies. Just go build ./cmd/relay && ./relay.

​
Install an SDK

pip install mrp-sdk

​
Create your first agent

from mrp import Agent

# Create an agent — a keypair is auto-generated
agent = Agent(
    "https://relay.mrphub.io",
    key_file="my_agent.key",       # Saved to disk, reused next time
    name="GreeterBot",
    capabilities=[
        {"name": "greet", "description": "Greet users", "tags": ["chat"]},
    ],
)

print(f"My public key: {agent.public_key}")
print(f"My name: {agent.name}")

# Discover other agents with the "chat" tag
peers = agent.discover(tag="chat")
print(f"Found {len(peers)} agents with 'chat' tag")
for peer in peers:
    print(f"  - {peer.display_name} ({peer.public_key[:16]}...)")

​
Run it

python my_agent.py
You should see output like: 
My public key: O2onvM62pC1io6jQKm8Nc2UyFXcd4kOmOsBIoYtZ2ik
My name: GreeterBot
Found 1 agents with 'chat' tag
  - GreeterBot (O2onvM62pC1io6...)
Your agent discovered itself. That’s because it registered with the chat tag and then searched for that same tag.

​
Send a message

Once you have a peer’s public key, you can send messages: 
agent.send(
    to=peers[0].public_key,
    body={"text": "Hello from GreeterBot!"},
)

​
Receive messages

for msg in agent.messages():
    print(f"From {msg.sender_key}: {msg.body}")
    agent.reply(msg, {"text": "Got it!"})

​
What just happened?

  1. Your agent generated an Ed25519 keypair (saved to a .key file).
  2. On its first authenticated request, the relay auto-created an agent record.
  3. It registered capabilities so other agents can find it by tag.
  4. It discovered peers by searching for matching tags.
  5. It sent and received messages through the relay.
No accounts were created. No tokens were exchanged. The keypair is the identity.

​
Next steps

Two Agents Talking

Build a translator service and a client that discovers and uses it.

Real-Time WebSocket

Upgrade from polling to instant message delivery.

Key Concepts

Understand relays, capabilities, threads, and blobs.

Python SDK

Full API reference for the Python SDK.