Content is missing or empty
Run mcp-aiom info and list the framework. Check which source and directory the client's process uses: an explicitly selected directory that is unavailable does not fall back to installed content. Remove the override, or ask its owner for the complete collection, then restart your server.
The framework version is unknown or different
An unknown version means version information is unavailable; it does not establish that the collection is empty. In directory mode, use the prompt or version-check tool rather than relying on the info display; do not guess a version. A mismatch is a completed comparison with matches: false, not a migration: report both values and follow your workspace's review process. Restart after version information changes.
A skill is absent or incomplete
Refresh discovery. If skills/list returns method not found, use the aiom_skill tool instead. If skills/get returns invalid params, use a uri exactly as skills/list returned it. A skill's supporting files are read through skill://<skill-name>/<file-path> or the tool's path argument, and they are not installed or run.
The listing shows a .gitkeep specification
Releases up to 0.5.9 list an empty placeholder named .gitkeep among the specifications. It is not a rule: leave it out of the loading set. Release 0.5.10 and later no longer list it.
The prompt says local override is enabled when you did not ask for it
Check whether MCP_AIOM_ALLOW_LOCAL_OVERRIDE is set in the environment that launches the server; the startup banner only reports the --allow-local-override flag, and on version 0.4.3 and earlier any value enables it, even 0. From version 0.5.0, 0, false, no, off and an empty value keep it disabled. Remove the variable, restart the server and request the prompt again.
Long instructions stop partway
Follow the returned next_offset until truncated is absent. Offsets count characters. Document and supporting-file reads also return continuations; requesting a skill does not automatically retrieve or install its supporting files.
A directory update is not visible
Change notifications are hints. Refresh the catalogue or reconnect, then read the document again. An installed collection changes with the installation, not with an unrelated local edit.
The client cannot connect
Confirm the client finds the command and launches it with serve, with nothing printed to stdout by a wrapper. Stdio and Unix sockets are supported. For a socket, use a directory that permits your client and belongs to your process only.
Prepare a support report
Share the installed version, the selected source, the kind and name you requested, the client and transport, the version-check outcome and the redacted error, and say which step last worked.
What you getGuidance your agent can list and read again, from the collection you intended.