`maqpna evidence register`

Export the register of third-party providers (DORA Art. 28)

Observe-o json | yaml

Synopsis#

maqpna evidence register [--gateway URL] [--format table|json|csv] [--since RFC3339] [--until RFC3339] [-n NS] [--agent A] [--include-unused] [--out FILE]

Description#

From the help of maqpna evidence:

generate builds a signed, auditor-ready evidence pack for one framework, one system and one period from the audit ledger and the configuration in force (paid: the evidence-packs licence feature or the Sovereign edition). verify checks a pack offline and needs no licence. frameworks lists the control mappings. A pack supports, and does not certify, compliance (docs/evidence-packs.md).

The register lists every external MCP server, model endpoint and A2A peer with first and last use, call counts, residency and cost (DORA Art. 28(3) register of information).

Flags#

Flag	Type	Description	Default
`--agent`	string	agent filter	none
`--format`	string	table \| json \| csv	`table`
`--gateway`	string	gateway base URL (env MAQPNA_GATEWAY_URL; default: the context's gateway)	none
`--include-unused`	switch	also list configured providers that were never called	none
`--oidc-token-file`	string	file holding an OIDC access token for the admin API (env MAQPNA_OIDC_TOKEN_FILE); wins over `--token`	none
`--out`	string	write to FILE	none
`--since`	string	RFC3339 start (inclusive)	none
`--token`	string	static admin token (env MAQPNA_ADMIN_TOKEN; dev/break-glass)	none
`--until`	string	RFC3339 end (exclusive)	none

The global flags (--context, -o, --no-color, ...) work with every command.

Examples#

$ maqpna evidence register
$ maqpna evidence register --format csv --since 2026-01-01T00:00:00Z --out register.csv

What happens when you run it#

Talks to the gateway: --gateway, else MAQPNA_GATEWAY_URL, else the current context's gateway (maqpna context).
Authenticates to the admin API with the token stored by maqpna login, --oidc-token-file, or a static --token (MAQPNA_ADMIN_TOKEN).
Prints a table by default; -o json or -o yaml print the data, and --jq EXPR filters the JSON.

Exit codes#

Code	Meaning
`0`	success
`1`	error (the message says what failed, with a hint when there is one)
`2`	usage error: unknown flag, missing argument or bad value; the synopsis is printed
`3`	a check failed, a change is blocked, or a result did not match (tamper, policy mismatch) (not used by this command)

Terminal demo#

maqpna evidence register.cast

maqpna evidence register