Skip to main content

Management Tool Catalog

The Management MCP surface exposes 57 tools across 10 categories. These tools allow AI agents and automation systems to manage the full Zerq platform — creating collections, configuring proxies, managing clients, rotating credentials, and querying observability data.

All Management MCP requests require an OIDC token: Authorization: Bearer <id_token>. Access is controlled by RBAC roles assigned to the authenticated user.


Tool categories

CategoryCountDescription
Collections7Create, read, update, delete, and toggle collection status
Proxies5Manage proxy routes within collections
Workflow9Manage, validate, and test proxy workflows and trigger capture
Policies6Rate limit and quota policies
Clients6Manage API consumer clients
Profiles8Manage auth profiles and credentials
Credentials5Manage backend secrets
Audit2Query audit logs
Metrics6Query dashboard metrics
Logs3Query and delete request logs

Collections (7 tools)

ToolDescription
list_collectionsReturns all collections with name, base path, status, and endpoint count
get_collectionReturns full detail for one collection including target URL, headers, and credential
get_collection_proxiesReturns all proxies for a specific collection
create_collectionCreates a new collection (name, base_path, endpoint URL, headers, credential)
update_collectionUpdates collection settings (name, description, endpoint, headers, credential)
delete_collectionPermanently deletes a collection and all its proxies
toggle_collection_statusPublishes or unpublishes a collection

Proxies (5 tools)

ToolDescription
list_proxiesReturns all proxies, optionally filtered by collection
get_proxyReturns full proxy detail including headers, parameters, schemas, and workflow status
create_proxyCreates a proxy (collection, name, method, path, target_path, headers, params, schema, streaming)
update_proxyUpdates an existing proxy's settings
delete_proxyPermanently removes a proxy

Workflow (9 tools)

ToolDescription
workflow_list_nodesReturns all workflow node types with schemas plus authoring metadata (entry_trigger, terminal_node, requires_source_handle, supported_source_handles, default_source_handle, dynamic_source_handles, wiring_hint)
workflow_list_templatesReturns all available prebuilt workflow templates
workflow_test_nodeExecutes a single node in isolation for testing
workflow_test_workflow_streamExecutes a full workflow test and returns streamed progress events
workflow_trigger_test_listenStarts a trigger test-listen session (HTTP webhook or IMAP capture)
workflow_trigger_test_streamReads the captured trigger event for a test-listen session
get_proxy_workflowReturns the current workflow definition for a proxy
update_proxy_workflowSaves a new workflow definition for a proxy
validate_proxy_workflowValidates a workflow definition and returns any schema or logic errors

Workflow entry triggers supported by workflow validation and update flows are http_trigger, manual_trigger, cron_trigger, kafka_consumer, and imap_trigger.


Policies (6 tools)

ToolDescription
list_policiesReturns all policies with rate limit and quota settings
get_policyReturns full detail for one policy
create_policyCreates a rate limit/quota policy
update_policyUpdates policy limits or window settings
toggle_policy_statusEnables or disables a policy
delete_policyPermanently removes a policy

Clients (6 tools)

ToolDescription
list_clientsReturns all clients with status, email, and collection count
get_clientReturns full client detail including portal access settings and authorized emails
create_clientCreates a client (name, email, collections, policy, portal access)
update_clientUpdates client settings including authorized emails and portal access toggle
toggle_client_statusActivates or deactivates a client
delete_clientPermanently removes a client and all its profiles

Profiles (8 tools)

ToolDescription
list_profilesReturns all profiles for a client with auth type and status
get_profileReturns full profile detail including method restrictions and IP allowlist
create_profileCreates a profile (name, auth_type, allowed_methods, allowed_ips)
update_profileUpdates profile settings
delete_profilePermanently removes a profile
get_profile_credentialsReturns the current credential metadata (not secret values)
rotate_profile_credentialsGenerates new credentials; old credentials are immediately invalidated
set_profile_auth_typeChanges the auth type of an existing profile

Credentials (5 tools)

ToolDescription
list_credentialsReturns all credentials with name and type
get_credentialsReturns credential metadata (type, fields) — never returns secret values
create_credentialsCreates a credential of any supported type
update_credentialsUpdates credential field values
delete_credentialsPermanently removes a credential

Audit (2 tools)

ToolDescription
list_audit_logsReturns audit log entries with filters (actor, action, resource, time range)
get_audit_logReturns full detail for one audit log entry

Metrics (6 tools)

ToolDescription
get_metrics_overviewReturns total requests, success rate, average latency, error count for a time period
get_metrics_status_distributionReturns request counts grouped by HTTP status class
get_metrics_method_distributionReturns request counts grouped by HTTP method
get_metrics_top_endpointsReturns the most-called endpoints ranked by request volume
get_metrics_failed_endpointsReturns endpoints with the highest error rates
get_metrics_requests_over_timeReturns request volume time series (interval: minute/hour/day/month)

Logs (3 tools)

ToolDescription
list_logsReturns request log entries with filters (path, method, status, client, latency, payload search)
get_logReturns full detail for one log entry including headers, body, and error
delete_logDeletes a specific log entry (admin only)