API Reference

Argus MCP exposes a REST API at /manage/v1/ for monitoring, inspecting, and controlling the gateway at runtime.

Base URL

http://<host>:<port>/manage/v1/

Default: http://127.0.0.1:9000/manage/v1/

Authentication

The management API uses bearer token authentication:

curl -H "Authorization: Bearer $ARGUS_MGMT_TOKEN" \
     http://localhost:9000/manage/v1/status

Token configuration:

• Config: server.management.token
• Env: ARGUS_MGMT_TOKEN
• If no token is configured, the API is open (no auth)
• GET /health is always public (no token required)

Endpoints

See Endpoint Reference for the complete API specification.

Quick Overview

Error Responses

All error responses follow this format:

{
  "error": "error_code",
  "message": "Human-readable description",
  "details": {}
}