Skip to content

docs: a server restart resets the session's API-discovery state #349

Description

@MattGyverLee

Restarting the MCP server resets the session's discovered-API set (discovered_api_count), so a write that passed the api_discovery_required gate before the restart is rejected after it until the entities are discovered again. This is expected behaviour, but nothing documents it. It looks like a regression to a user whose client reconnects silently.

Ask: note it in USAGE.md and/or docs/TOOL-CONTRACT.md (near _inline_discovery), with the fix: call flextools_get_object_api again, or start a new session.

Related closed issues: #42, #29 (other ways discovery state is lost).

Optional, documentation only.


Found during FlexToolsMCP specs/exclusive-access-gate (#343); ledger: specs/exclusive-access-gate/issues/filing-ledger.md. Filing authorized by the maintainer on 2026-10-02.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3documentationImprovements or additions to documentation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions