MCP Path

Unknown ServerKey

Unknown ServerKey is a public reference for extensions, external MCP sources, and bounded tool execution. It names the signal, policy, or flow an agent should understand before choosing a concrete tool.

Catalog path

Reference page for a documented MCP capability path.

Type: MCP path
Family: External MCP Gateway (Configuration & Lifecycle)
Effect: sensitive
Status: Reference
Path: 22.7

Purpose

What this entry explains

What it does

This reference explains Unknown ServerKey for extensions, external MCP sources, and bounded tool execution. It is kept as a named reference so agents can cite the flow without inventing a tool name.

Use when

Use this entry when an agent needs to handle the sensitive path "Unknown ServerKey" for extensions, external MCP sources, and bounded tool execution.
Use it as a reference path when the catalog describes a capability but no single public tool name is explicit.
Use it before chaining follow-up tools so the next step is based on current evidence.

Reference Use

How agents should cite and apply this area

Examples are maintained at family level and use only public tool names or reference paths already present in the catalog.

Signal, gate, behavior, boundary

Unknown ServerKey describes a gate for extensions, external MCP sources, and bounded tool execution. The path shows which signal, gate, behavior, or boundary must be checked before choosing a concrete tool.

When agents cite it

An agent cites this path when it needs Unknown ServerKey as context for a decision, block, target check, or follow-up tool choice.

Why no callable name

The public source does not name one callable tool for this path. The documentation therefore keeps it as a reference path and does not invent a callable name.

Signals and rule

Relevant response signals: current discovery and actual response status. Safety axes: Sensitive, External, User confirmation. The reference path alone is not permission to execute. Before acting, check current MCP discovery, visible target, scope, and the actual response.

Family example

A task in extensions, external MCP sources, and bounded tool execution can trigger powerful execution and therefore needs target, approval, and result check before the step.

The agent starts with nova.external_server_add, reads the current response or reference, and only then chooses the concrete next tool.

nova.external_server_add nova.external_servers nova.external_server_update

Current discovery, target, user control, warning signals, and result check come before execution.

Contract

Inputs and important response fields

This page is a public reference. Agents and integrators should still read current MCP tool discovery before execution, because schemas can be gated by settings or version.

Inputs

No stable public input field is derived from the catalog source for this path. Read current MCP discovery before execution.

Response fields

No fixed public response field is derived from the catalog source for this path. Use current tool discovery and the actual response before chaining the next step.

Safety

Boundary before execution

Effect

May touch sensitive data, permissions, credentials, identity, or external connection paths. Use only with explicit scope and visible user control.

Agent rule

Require explicit purpose and current context, avoid exposing secrets in prompts or logs, and stop when permission or identity state is unclear.

Human control

For humans, this entry marks the sensitive surface in extensions, external MCP sources, and bounded tool execution and keeps permission, credential, or external-connection handling explicit.

High-Impact Review

Execution boundary and recheck hints

Review category: Proxy/external connection

Execution boundary

External targets, proxies, gateways, and transport paths may be used only with checked target, status, and approval.

Typical false assumption

False assumption: a reachable external tool is automatically part of the allowed Nova tool chain.

Visible user control

Target, transport status, import or connection approval, and expected data movement must be visible.

Agent rule

Do not silently add third-party tools; check current approval, target, and response status before use.

Abort or recheck

Recheck if the gateway, proxy, remote source, or target system changes or emits warnings.

Safety Axes

How this path can affect work

Axes are stable catalog signals for humans, agents, and LLM discovery. One path can carry several axes.

Sensitive sensitive_data

Touches cookies, storage, clipboard, credentials, tokens, user content, identity, or private data.

Use only with bounded purpose and visible user control; do not guess, log, or forward sensitive values.

External external_connection

Uses proxy, external MCP gateways, network routes, third-party integrations, or import paths.

Check external target, transport status, and approval before use; do not silently chain third-party tools.

User confirmation user_confirmation

Requires visible confirmation, target review, approval, or deliberate user control.

Do not proceed until the required confirmation is visible or unambiguous in the current context.