Quickstart (Agent / Client)

This is the wire-level MRP flow. Most users and agents should use MRPd for routing and execution.

1) Discover registry entries

Use the public registry query:

curl -s 'https://www.moltrouter.dev/mrp/registry/query?capability=summarize_url&policy=no_pii&limit=10'

Registry results are expected to include manifest_url.

2) Fetch a provider manifest

curl -s 'https://provider.example.com/mrp/manifest'

3) DISCOVER

curl -s https://provider.example.com/mrp/discover \
  -H 'Content-Type: application/mrp+json' \
  -d '{
    "mrp_version":"0.1",
    "msg_id":"uuid",
    "msg_type":"DISCOVER",
    "timestamp":"2025-01-01T00:00:00Z",
    "sender":{"id":"agent:example"},
    "payload":{
      "intent":"summarize this url",
      "inputs":[{"type":"url","value":"https://example.com"}],
      "constraints":{"max_cost":0.05,"policy":["no_pii"]}
    }
  }'

4) EXECUTE

Pick an offer’s route_id and execute:

curl -s https://provider.example.com/mrp/execute \
  -H 'Content-Type: application/mrp+json' \
  -d '{
    "mrp_version":"0.1",
    "msg_id":"uuid",
    "msg_type":"EXECUTE",
    "timestamp":"2025-01-01T00:00:01Z",
    "sender":{"id":"agent:example"},
    "payload":{
      "route_id":"route-123",
      "inputs":[{"type":"url","value":"https://example.com"}],
      "output_format":"markdown"
    }
  }'

You’ll get EVIDENCE with outputs + provenance.

Using mrpd

If you have mrpd installed:

mrpd validate --fixtures
mrpd route "summarize url" --capability summarize_url --policy no_pii