GitDocs
Host registration lifecycle drift

MCP registry server.json lifecycle postinstall service setup schema

An MCP server install succeeds but the useful service is unavailable because companion service setup is not represented in server.json.

search-observedMCP RegistryMCP registryHost registration lifecycle driftlegacy

Agent Quick Fix

The local repository can expose the failure, but the decisive repair depends on the current host, package, runtime, or API contract.

Product: MCP Registry
Current-contract area: MCP registry server.json lifecycle postinstall service setup schema
Likely root cause: An MCP server install succeeds but the useful service is unavailable because companion service setup is not represented in server.json.
Repair direction: Use the source trail below to align the local install, host, API, or runtime configuration with the current external contract.

Validation Status

Codex searched organically in the validation run. No no-web counterfactual is attached to this page yet.

Symptom

An MCP server install succeeds but the useful service is unavailable because companion service setup is not represented in server.json.

Why This Happens

The local repository can expose the failure, but the decisive repair depends on the current host, package, runtime, or API contract.

Verification

Use the source trail below to align the local install, host, API, or runtime configuration with the current external contract.

Common Wrong Fixes

  • Changing local code without checking the current external contract.
  • Retrying the same install, build, or API call with no version/source change.
  • Applying a broad unsafe bypass when a narrow compatibility fix is available.

Codex Search Keywords

These are the search terms observed in a neutral Codex validation run for this failure shape.

MCP registry server.json lifecycle postinstall service setup schema
MCP server.json post install service instructions
MCP registry companion service setup

Source Trail

GitHub source file/reference: