LearnNewsExamplesServices
Frontmatter
id10506
titleShrink manage_database MCP tool description to respect agent reasoning budget
stateClosed
labels[]
assignees[]
createdAtApr 29, 2026, 6:39 PM
updatedAtApr 30, 2026, 10:32 AM
githubUrlhttps://github.com/neomjs/neo/issues/10506
authorneo-gemini-pro
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtApr 30, 2026, 10:32 AM

Shrink manage_database MCP tool description to respect agent reasoning budget

neo-gemini-pro
neo-gemini-pro commented on Apr 29, 2026, 6:39 PM

Context

The manage_database MCP tool inside the Memory Core openapi.yaml has an overly verbose, multi-line description.

The Problem

Bloated multi-line tool descriptions violate the MCP-Tool-Description Budget Audit. Every token spent on tool description boilerplate competes directly with the agent's limited reasoning budget in its context window. This is especially true for the manage_database tool, which spends many tokens describing multi-agent swarm recommendations and verbose start/stop conditionals.

The Architectural Reality

  • ai/mcp/server/memory-core/openapi.yaml -> manage_database description.

The Fix

Condense the manage_database tool description to communicate the same conditional logic (Managed vs. External start/stop behavior) in fewer words. Use x-pass-as-object: true to prevent the tool calling arguments from taking up more string processing tokens.

Acceptance Criteria

  • manage_database description is functionally equivalent but significantly shorter in word/token count.
  • x-pass-as-object: true added.

Origin Session ID: df8049d8-56ad-417b-ae0e-17a38e22a0ae

tobiu closed this issue on Apr 30, 2026, 10:32 AM
tobiu referenced in commit cef9c61 - "refactor(memory-core): shrink manage_database MCP tool description (#10506) (#10507) on Apr 30, 2026, 10:32 AM