Connect your agent (MCP)

AIOS Govern exposes a streamable-HTTP MCP server so your agent can submit governance requests and act on decisions through native tool calls.

Endpoint

https://govern.cutlineadvisory.app/api/mcp

Authenticate with a Bearer MCP key (kind mcp or agent) from /agents. The same key scopes every tool to your account.

Client config

Paste this into your MCP client config (Claude Desktop, Cursor, and similar):

{
  "mcpServers": {
    "aigos": {
      "url": "https://govern.cutlineadvisory.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_KEY>"
      }
    }
  }
}

Tool discovery

Agents discover the full toolset at connect time via the standard tools/list JSON-RPC method — no hard-coding required. The server also implements initialize and ping.

Available tools

• submit_governance_request — Submit an envelope (approval, spend, choice, info…) to a human inbox.
• get_request_status — Read a request's current state and its latest decision summary.
• wait_for_decision — Block up to 60s for a decision; otherwise return re-poll guidance.
• list_pending_requests — List the account's envelopes still pending.
• list_folders — List the account's folders.
• acknowledge — Acknowledge an informational request.
• complete — Approve when the route allows, else mark informational.
• approve — Approve a request (self-approval blocked on route 'approval').
• reject — Reject a request (self-approval blocked on route 'approval').
• request_info — Send a request back asking for more information.
• escalate — Escalate a request to a higher authority.

Separation of duties

An agent cannot self-approve. If a request was created with route: "approval" by this same agent, calling approve or reject is refused — a different human must decide. Use route: "approval_self" when the submitting key's bound user is allowed to approve their own request.