Enable high-throughput mode on a FIFO queue at creation or via SetQueueAttributes: set FifoThroughputLimit=perMessageGroupId and DeduplicationScope=messageGroup
With perMessageGroupId throughput limit, each message group ID can sustain up to 3,000 messages per second with batching (or 300 TPS without batching); total queue throughput scales with the number of distinct message group IDs in use
Set ContentBasedDeduplication=true to automatically derive the deduplication ID from the SHA-256 hash of the message body, or provide an explicit MessageDeduplicationId on each send for deterministic control
Design message group IDs for parallelism: use a fine-grained key (e.g. order_id) to maximise throughput; coarse keys (e.g. a single static group) collapse all traffic to one sequenced lane
Test ordering guarantee: within a single message group ID, messages are delivered strictly in-order and only one consumer processes messages from a group at a time; across groups, ordering is not guaranteed
For deduplication scope=queue (the classic non-high-throughput setting), a duplicate check applies queue-wide within the 5-minute deduplication window — this is incompatible with high-throughput mode
Known gotchas
DeduplicationScope=messageGroup and FifoThroughputLimit=perMessageGroupId must be set together; setting one without the other leaves the queue in the original 3,000 TPS-per-queue mode
The deduplication window is always exactly 5 minutes and cannot be changed; if a producer retries after 5 minutes with the same MessageDeduplicationId, the message is treated as a new message and delivered again
High-throughput FIFO queues still enforce strict per-group ordering; if a consumer holds a message in-flight (visibility timeout not expired), subsequent messages in the same group are withheld — tune visibility timeout and consumer processing time carefully
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