How governance rules work
A governance rule is an explicit allow or block decision keyed on two target types: servers and clients.- Servers — Tool calls to a named upstream MCP server. Add an optional tool filter to scope the decision to specific tools instead of every tool on that server.
- Clients — Tool calls originating from a named MCP client (for example,
claude-desktop,cursor,claude-code). You can also target a client type (a whole category of clients) when you want the decision to apply to every instance of that client.
Governance Posture
Posture is the baseline admission decision for tool calls that no rule matches. It is set per scope and answers a single question: “If governance has no opinion, what should happen?”| Posture | Behavior for unmatched calls | When to use |
|---|---|---|
| default_allow | Allow the call through. This is the historical behavior and the default for new organizations. | Permissive baseline. Rules act as a blocklist that carves exceptions out of “everything is allowed.” |
| default_deny | Block the call. Only servers, tools, and clients covered by an explicit allow rule can reach the upstream server. | Zero-trust baseline. Rules act as an allowlist of pre-approved access. Use this when you want to ensure nothing reaches an upstream server without being explicitly named. |
Scoping
Governance rules can be configured at three levels, exactly like guardrails:| Scope | Description |
|---|---|
| Organization | Applies to every workspace and gateway in your org. The default starting point for blanket policies. |
| Workspace | Applies to every gateway in a workspace. Inherits all organization-scoped rules and adds to them. |
| Gateway | Applies to a single gateway. Inherits all organization and workspace rules and adds to them. |
Who can manage governance
Only users with the owner or admin role can create, edit, move, or delete governance rules. Members and viewers can see the Governance page and the list of active rules, but the Create rule, Edit, and Delete controls are hidden. See RBAC for the full permission matrix.Creating a rule
There are two ways to create a governance rule.Quick block from the Servers page
The fastest way to block an entire MCP server organization-wide.
The rule appears immediately on the Governance page and is synced to all connected gateways within seconds.
Full rule editor from the Governance page
Use the full editor when you need to target clients, filter to specific tools, or scope the rule to a workspace or gateway instead of the whole organization.Pick a scope
Choose Organization, Workspace, or Gateway. The form previews exactly which clients the rule will apply to once active.
Name the rule
Use a short, descriptive name (for example,
Block github-mcp or Sandbox new finance-mcp). The name appears on the Governance page and in audit log events.Add target servers
In the Servers section, pick one or more servers from the dropdown. The list is populated from upstream servers Ultra has seen across your organization.Click the tool summary on a server row to optionally restrict the block to specific tools. Leave it as all tools to block the entire server.
Add target clients
In the Clients section, pick one or more clients to limit the rule to specific MCP clients. Leave both lists populated to require a match on both server and client. Leave the Servers section empty to block every call from a listed client regardless of which server it targets.
Editing or moving a rule
Click Edit on any rule you own at the current scope to change its name or its targets. Inherited rules are read-only at lower scopes; navigate to the scope they came from to edit them. To move a rule to a different scope, open it and click Change scope…. Picking a new scope creates the rule at the new scope and deletes the original. Both events are recorded in the audit log.Removing a rule
Click Delete on the rule’s row. Tool calls that the rule was blocking are allowed again after the change syncs to your gateways. Existing audit log entries for past denials are preserved.Transitioning to default_deny
Switching a scope fromdefault_allow to default_deny is a meaningful change: every server, tool, and client without an explicit allow rule will immediately stop working in that scope. Ultra Hub helps you make the transition without breaking live traffic.
Open Posture on the scope you are changing
Navigate to Governance in the Hub sidebar and select the scope (organization or workspace) you want to lock down.
Pick default_deny
Click the posture control and choose default_deny. A confirmation dialog opens listing every server currently in use within the scope that does not yet have an allow rule.
Confirm to auto-create allow rules
Confirm the dialog to auto-generate one allow rule per listed server, scoped to the same place as the posture change. These rules are tagged as posture-generated so Ultra can clean them up later. The posture flips to
default_deny once the rules are saved.Tighten over time
Use the Access view to see what is being allowed by the auto-generated rules versus by explicit policy. Replace the auto-generated rules with narrower allow rules (specific tools, specific clients) as you build out your allowlist, and delete the ones you no longer need.
default_allow cleans up automatically: every posture-generated allow rule in the scope is deleted in the same action, restoring the previous “rules as a blocklist” model. Rules you created by hand (not posture-generated) are left in place.
Audit log behavior
Every governance decision generates anevent_type: guardrail event in the audit log with guardrail_type: governance. Each event records:
- The decision (
outcome: denyfor blocks,outcome: allowfor allow rules) - The reason (
explicit rule,default deny posture, or the rule’s name) - The MCP server that was targeted
- The tool the client tried to call
- The user and client identity behind the call
default_allow and default_deny.
Access view
The Access panel on the Governance page is a per-server view of how governance is treating live traffic in the selected scope. Each row carries:| Column | Description |
|---|---|
| Server | The upstream MCP server. |
| Status | Managed when Ultra is the source of truth for the server, Unmanaged when drift was detected on a client, or Partial when some clients have it and others don’t. |
| Access | Allowed or Blocked, based on the effective rules and posture at the row’s scope. |
| Reason | One of: Explicit allow rule, Explicit block rule, Default allow, or Default deny. |
| Rule | The matched governance rule, if the decision came from a rule rather than the posture. |
| Context | Whether the decision is set directly at this scope or inherited from a parent. |
Common scenarios
| Scenario | Recommended action |
|---|---|
| Decommissioning an internal MCP server | Quick-block the server from the Servers page, then remove it from your gateway configs once traffic has stopped. |
| Vendor outage or compromise | Quick-block the affected server, unblock once the issue is resolved. |
| Blocking a server only inside one workspace | Create a workspace-scoped block rule targeting that server. The block applies inside the workspace and adds to any org-wide rules already in effect. |
| Blocking a single dangerous tool but keeping the server | Create a block rule with the server selected and a tool filter listing only the tools to block. |
| Sandboxing a new client until reviewed | Create a client-scoped block rule across the org while the integration is evaluated. |
| Zero-trust for a sensitive workspace | Set the workspace posture to default_deny, accept the auto-generated allow rules for currently-used servers, then narrow them down to specific tools and clients over time. |
| Fine-grained matching on parameters or content | Use a custom guardrail instead. Governance only matches on server, tool, and client identity. |
Governance vs. guardrails
Governance and guardrails answer different questions:| Governance | Guardrails | |
|---|---|---|
| Question it answers | Should this server, tool, or client be reachable at all? | Is this specific tool call safe? |
| Granularity | Server, tool, or client identity | Tool name, parameters, content patterns, user, and more |
| Action | Always block | Block, alert, monitor, or redact |
| Scope | Organization, workspace, or gateway | Organization, workspace, or gateway |
Related
Guardrails
Enforce policies on tool names, parameters, and content
Servers
Browse upstream servers and quick-block from the table
Audit Log
Review every governance and guardrail enforcement event
RBAC
Control who can manage governance rules