Create a persistent topic with bin/pulsar-admin topics create persistent://YOUR_TENANT/YOUR_NAMESPACE/YOUR_TOPIC
Create a subscription on the topic: bin/pulsar-admin topics create-subscription -s YOUR_SUBSCRIPTION --subscription-type Shared persistent://...
Choose subscription type: Exclusive (one consumer), Shared (round-robin, any order), Failover (active-standby), or Key_Shared (ordered per key)
Produce and consume using the Pulsar client library; configure consumer with subscriptionType and the subscription name matching what was created
Set retention policies on the namespace to control how long acknowledged and unacknowledged messages are retained on the topic
Known gotchas
In Shared subscription mode, messages are distributed without ordering guarantees; use Key_Shared if you need per-key ordering with parallelism
Pulsar uses a cursor per subscription to track acknowledgements; if a subscription is never consumed, messages accumulate and the backlog can grow unboundedly
Pulsar topic auto-creation is enabled by default in some configurations; enforce namespace policies to prevent accidental topic proliferation in production
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp