# list_dlq

List entries currently in this project's dead-letter queue, newest first. One inbound request fans out per-target, so a single failed request may produce several DLQ entries with different targetIds. Returns {total, limit, offset, rows[], evictedCount} where each row has id (Redis stream id), requestId, targetId, configVersion (the published config that authorised the delivery; 0 means unstamped), failureReason, failedAttempts, failedAt, payload (the original Consumer queue entry JSON); evictedCount is the lifetime count of entries the queue's capacity cap discarded before they could be triaged. DLQ entries — including the original request body and headers — are kept for up to 30 days from the failure time or until cleared, then purged automatically (or discarded early past capacity — see evictedCount); they are never written to a database. get_request still answers what happened to a purged/evicted/discarded entry's inbound request for the project's requestLogRetentionDays window, independent of whether the DLQ row itself still exists. requestId is the durable handle across a retry: an entry's own id changes every time it is replayed and later dead-letters again, so get_dlq_entry accepts a requestId lookup as well as id.

Agent View of the PolicyLayer registry record for `list_dlq`. HTML page: https://policylayer.com/tools/dev-echorelay-management/list-dlq

## Facts

- Tool: `list_dlq`
- Server: EchoRelay (`https://mcp.echorelay.dev`) — https://policylayer.com/tools/dev-echorelay-management.md
- Homepage: https://github.com/https://mcp.echorelay.dev
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 2
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | Page size. Default 50. |
| `offset` | integer | no | Page offset. Default 0. |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_dlq",
    "arguments": {}
  }
}
```

## Why list_dlq is rated Low

Even though list_dlq only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

## Use case

AI agents call list_dlq to retrieve information from EchoRelay without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches EchoRelay:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "list_dlq": {}
  }
}
```

## Other tools on EchoRelay (77)

- `cancel_line_publish` — Destructive — https://policylayer.com/tools/dev-echorelay-management/cancel-line-publish.md
- `delete_credential` — Destructive — https://policylayer.com/tools/dev-echorelay-management/delete-credential.md
- `delete_endpoint` — Destructive — https://policylayer.com/tools/dev-echorelay-management/delete-endpoint.md
- `delete_line` — Destructive — https://policylayer.com/tools/dev-echorelay-management/delete-line.md
- `discard_dlq_entry` — Destructive — https://policylayer.com/tools/dev-echorelay-management/discard-dlq-entry.md
- `discard_draft_endpoint` — Destructive — https://policylayer.com/tools/dev-echorelay-management/discard-draft-endpoint.md
- `discard_line_draft` — Destructive — https://policylayer.com/tools/dev-echorelay-management/discard-line-draft.md
- `remove_member` — Destructive — https://policylayer.com/tools/dev-echorelay-management/remove-member.md
- `revoke_api_key` — Destructive — https://policylayer.com/tools/dev-echorelay-management/revoke-api-key.md
- `revoke_project_token` — Destructive — https://policylayer.com/tools/dev-echorelay-management/revoke-project-token.md
- `rollback_config` — Destructive — https://policylayer.com/tools/dev-echorelay-management/rollback-config.md
- `dry_run_endpoint` — Execute — https://policylayer.com/tools/dev-echorelay-management/dry-run-endpoint.md
- `duplicate_line` — Execute — https://policylayer.com/tools/dev-echorelay-management/duplicate-line.md
- `cancel_subscription` — Financial — https://policylayer.com/tools/dev-echorelay-management/cancel-subscription.md
- `change_plan` — Financial — https://policylayer.com/tools/dev-echorelay-management/change-plan.md
- `downgrade_addon` — Financial — https://policylayer.com/tools/dev-echorelay-management/downgrade-addon.md
- `retry_dlq_entry` — Financial — https://policylayer.com/tools/dev-echorelay-management/retry-dlq-entry.md
- `start_subscription` — Financial — https://policylayer.com/tools/dev-echorelay-management/start-subscription.md
- `start_topup` — Financial — https://policylayer.com/tools/dev-echorelay-management/start-topup.md
- `subscribe_addon` — Financial — https://policylayer.com/tools/dev-echorelay-management/subscribe-addon.md
- `unsubscribe_addon` — Financial — https://policylayer.com/tools/dev-echorelay-management/unsubscribe-addon.md
- `default_endpoint_template` — Read — https://policylayer.com/tools/dev-echorelay-management/default-endpoint-template.md
- `get_billing` — Read — https://policylayer.com/tools/dev-echorelay-management/get-billing.md
- `get_config` — Read — https://policylayer.com/tools/dev-echorelay-management/get-config.md
- `get_dlq_entry` — Read — https://policylayer.com/tools/dev-echorelay-management/get-dlq-entry.md
- `get_endpoint` — Read — https://policylayer.com/tools/dev-echorelay-management/get-endpoint.md
- `get_key_policy` — Read — https://policylayer.com/tools/dev-echorelay-management/get-key-policy.md
- `get_line_draft` — Read — https://policylayer.com/tools/dev-echorelay-management/get-line-draft.md
- `get_metrics` — Read — https://policylayer.com/tools/dev-echorelay-management/get-metrics.md
- `get_project` — Read — https://policylayer.com/tools/dev-echorelay-management/get-project.md
- …and 47 more: https://policylayer.com/tools/dev-echorelay-management.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=dev-echorelay-management · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/dev-echorelay-management