Skip to content

`maqpna mcp`

List MCP servers, their tools and pins (tool pinning)

Govern-o json | yaml

Synopsis#

maqpna mcp list  [--gateway URL] [-n NS]
maqpna mcp tools NS/NAME [--gateway URL] [--agent A] [--drift-only]
maqpna mcp pin   NS/NAME [--gateway URL] [--target toolpolicy|mcpserver] [--mode enforce|learn|off] [--first] [--out FILE]

Description#

pin prints the observed tool definition hashes as a toolPins block (YAML; -o json for JSON) to paste into a ToolPolicy (default) or an MCPServer (--target mcpserver).

Subcommands#

maqpna mcp listList MCP servers maqpna mcp toolsList an MCP server's tools with their pins and drift maqpna mcp pinPrint the observed tool definition hashes as a toolPins block

Examples#

$ maqpna mcp list -n team-a
$ maqpna mcp tools team-a/github --drift-only
$ maqpna mcp pin team-a/github --mode enforce --out pins.yaml

What happens when you run it#

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 mcp.cast