maqpna dev up
Start a local MAQPNA: identity broker, gateway and the mcp-echo test MCP server
Synopsis#
maqpna dev up [--dir .maqpna] [--gateway-port 8080] [--identity-port 8081] [--echo-port 8090] [--policy FILE]
[--upstream NAME=URL]... [--model NAME=URL[,MODEL]] [--stub-llm [--stub-llm-script F]] [--no-echo] [--from-source]
[--dlp-profile FILE] [--checkpoint-key FILE] [--gateway-config FILE]Description#
From the help of maqpna dev:
up starts maqpna-identity, maqpna-gateway and (unless --no-echo) mcp-echo from the installed binaries (next to maqpna or on PATH); in a source checkout with --from-source, or when they are missing, they are built with go build. run mints a session token from the local broker and runs CMD with the same environment the operator gives a sandbox (MAQPNA_GATEWAY_URL, MAQPNA_TOKEN, MAQPNA_SESSION, MAQPNA_AGENT, MAQPNA_TOOL_<NAME>_URL), then prints what the session did. Exit code: CMD's.
Flags#
| Flag | Type | Description | Default |
|---|---|---|---|
--checkpoint-key | string | audit checkpoint signing key (Ed25519 PKCS#8 PEM file; auditCheckpointKey) | none |
--dir | string | state directory (keys, config, ledger, logs) | .maqpna |
--dlp-profile | string | DLP profile JSON file, applied to all traffic as profile "dev" (dlpProfiles.dev, dlp.defaultProfile) | none |
--echo-port | int | mcp-echo port | 8090 |
--from-source | switch | build the servers from this source checkout with go build | none |
--gateway-config | string | JSON object merged over the generated .maqpna/gateway.json (top-level keys replace; e.g. auditSinks, pricingFile) | none |
--gateway-port | int | gateway port | 8080 |
--identity-port | int | identity broker port | 8081 |
--model | string | OpenAI-compatible model route NAME=URL[,MODEL] (repeatable) | none |
--no-echo | switch | do not start the mcp-echo test server | none |
--policy | string | policy JSON file (default: the built-in dev policy) | none |
--stub-llm | switch | also start stub-llm (scripted OpenAI-compatible model, no API key) as model route "stub" | none |
--stub-llm-port | int | stub-llm port | 8000 |
--stub-llm-script | string | stub-llm script (YAML; default: call echo, then a denied delete, then answer) | none |
--upstream | string | extra MCP server NAME=URL (repeatable) | none |
The global flags (--context, -o, --no-color, ...) work with every command.
Examples#
# Start a local MAQPNA, run your agent under it, then see what it did
maqpna dev up
# Use a model route backed by the scripted stub model
maqpna dev up --stub-llmWhat happens when you run it#
- Prints a table by default;
-o jsonor-o yamlprint the data, and--jq EXPRfilters 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) |