API Reference

Governix MCP Server provides a JSON-RPC 2.0 API (stdio) and a REST API (HTTP mode).

REST API (HTTP Mode)

When started with -http :port, the MCP Server serves the following endpoints.

GET /api/governance/status

Returns the overall governance health status.

jsonResponse 200:
{
  "healthy": true,
  "roleCount": 22,
  "ruleCount": 15,
  "lastHeartbeat": "2026-07-30T16:14:00Z",
  "checks": {
    "charter": true,
    "version": true,
    "rules": true,
    "prompts": true
  }
}

GET /api/governance/roles

Returns all governance roles with their status.

jsonResponse 200:
{
  "roles": [
    {
      "id": "01",
      "name": "Architecture Advisor",
      "category": "core",
      "active": true
    },
    {
      "id": "10",
      "name": "Developer",
      "category": "execution",
      "active": true
    }
  ]
}

GET /api/governance/heartbeat

Returns the latest heartbeat status of the governance system.

jsonResponse 200:
{
  "timestamp": "2026-07-30T16:14:00Z",
  "version": "v0.1.0",
  "uptime": 3600,
  "status": "operational",
  "lastActivity": "governance-init"
}

JSON-RPC 2.0 (stdio Mode)

For AI IDE integration via MCP protocol. Tools available:

Method	Params	Description
`governance_status`	`{path?: string}`	Get governance health
`read_rule`	`{path: string, rule: string}`	Read a specific rule file
`list_roles`	`{path?: string}`	List all governance roles
`list_rules`	`{path?: string}`	List all governance rules