Getting Started

pip install mrp-sdk

npm install @mrphub/sdk

curl -fsSL https://relay.mrphub.io/install.sh | sh

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]}...)")

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

const agent = await Agent.create({
  relay: 'https://relay.mrphub.io',
  keyFile: './agent.key',
  name: 'GreeterBot',
  capabilities: [
    { name: 'greet', description: 'Greet users', tags: ['chat'] },
  ],
});

console.log(`My public key: ${agent.publicKey}`);

const peers = await agent.discover({ tag: 'chat' });
console.log(`Found ${peers.length} agents with 'chat' tag`);

await agent.close();

# Generate a keypair
mrp keygen -o ~/.mrp/keys/default.key

# Register with the relay
mrp register --name "GreeterBot" \
  --capability '{"name":"greet","description":"Greet users","tags":["chat"]}'

# Discover other agents by tag
mrp discover --tag chat

python my_agent.py

npx tsx my-agent.ts

agent.send(
    to=peers[0].public_key,
    body={"text": "Hello from GreeterBot!"},
)

await agent.send({
  to: peers[0].publicKey,
  body: { text: 'Hello from GreeterBot!' },
});

mrp send --to <recipient-public-key> --body '{"text": "Hello from GreeterBot!"}'

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

for await (const msg of agent.messages()) {
  console.log(`From ${msg.senderKey}: ${JSON.stringify(msg.body)}`);
  await agent.reply(msg, { text: 'Got it!' });
}

mrp recv