Update docs package.json to use mintlify dev server for local development.
The start script now runs `mintlify dev` instead of the Node.js proxy server.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

- Update title from "MCP Client Guide" to "MCP Client" for consistency
- Add example links at top of guide for quick reference
- Fix footer format to match other guides (standard copyright)
- Add database-mixin to SDK navigation (Mixins & Utilities)
- Document gaia mcp test-client CLI command in reference
- Clean up spec file formatting and footer

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

- Provide single-file, copy-pasteable example matching working patterns
- Include proper initialization (skip_lemonade, explicit __init__ calls)
- Add system prompt rebuilding for MCP tool registration
- Show expected output for better user experience
- Use process_query instead of run for consistency with examples
- Add tip pointing to production config-based pattern

Fixes incomplete Quick Start that caused NameError when users tried to
follow the guide. Now provides a fully working example users can run
immediately without modifications.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

The previous Quick Start was broken because it lacked the JSON response
format instructions that the Agent base class requires for tool calling.
Without these instructions, the LLM outputs tool calls as text instead
of executing them.

Changes:
- Add complete response format instructions to _rebuild_system_prompt
- Include tool calling JSON schema and rules
- Update expected output to show actual tool execution
- Make it clear this is a complete, working example

This matches the pattern used in working examples like
mcp_multi_server_agent.py and mcp_config_based_agent.py.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

- Simplified mcp_config_based_agent.py from 195 to 64 lines
  - Reduced docstring from 43 to 3 lines
  - Removed verbose print statements and status output
  - Added silent_mode=True for clean console output

- Changed MCP client logging from INFO to DEBUG
  - mcp_client_manager.py: 8 log level changes
  - mcp_client.py: 4 log level changes
  - mcp_client_mixin.py: 5 log level changes
  - Now only shows essential output by default

- Updated MCP client guide documentation
  - Replaced verbose examples with actual clean output
  - Fixed prerequisites to require [mcp] extra
  - Added [mcp,dev] option for development

- Fixed setup.py missing packages
  - Added gaia.mcp.client
  - Added gaia.mcp.client.transports

Example now produces clean output:
Connected: memory, thinking, time
Agent: The current time in Tokyo is 11:59 PM...

- Added Step 2 to setup.mdx for Node.js installation via NVM
  - Windows: winget or manual download from GitHub
  - Linux: curl script from nvm-sh/nvm
  - Version: 20.20.0 (latest LTS with January 2026 security fixes)

- Updated system requirements table with Node.js as optional

- Added .nvmrc file with v20.20.0

- Updated MCP client guide prerequisites
  - Added example of npm-based MCP server command
  - Links to setup guide for NVM installation

- Added prerequisites table to MCP client spec
  - Documents GAIA [mcp] and Node.js dependencies

Phase 0: File Reorganization
- Move mcp_client_mixin.py to src/gaia/mcp/mixin.py (follows database mixin pattern)
- Update imports across codebase (examples, tests, docs)
- Reorganize docs.json navigation:
  - SDK Reference: Move mcp-client to SDKs group
  - Specifications: Move mcp-agent to Core Framework
  - Specifications: Move mcp-server to SDKs group
  - Specifications: Move mcp-client to Tool Mixins, rename to "MCP Tool Mixin"

Phase 1: Automatic System Prompt Rebuild
- Add rebuild_system_prompt() method to Agent base class
- Automatically called in Agent.__init__ after tool registration
- MCPClientMixin auto-calls rebuild after connecting MCP servers
- ChatAgent simplified to use base class method
- Remove manual _rebuild_system_prompt() from examples and tests

This eliminates the need for users to manually rebuild system prompts when
dynamically adding MCP tools or indexing documents.

Changes: 20 files, -406/+160 lines
Tests: 49/49 unit, 9/9 integration pass

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

High priority fixes:
- Clarify only stdio transport is currently supported (HTTP exists but not integrated)
- Add missing load_mcp_servers_from_config() method documentation
- Document call_tool() error response format

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

Following patterns from chat.mdx and llm.mdx:
- Add quick reference header with navigation links
- Add source code info box (updated to src/gaia/mcp/mixin.py)
- Add import statement note
- Add development badge
- Add comprehensive code examples:
  - Connect multiple servers
  - Load servers from config
  - Direct client usage (without agent)
  - Using MCPClientManager
  - Enhanced error handling
  - Enhanced debug mode
- Add copyright footer

Expanded from 160 to 332 lines.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

Navigation fixes (docs.json):
- Add MCP Client SDK to SDK Reference → Mixins & Utilities
- Move spec/mcp-agent from Core Framework to Agents & Apps
- Move spec/routing-agent from Infrastructure to Agents & Apps

Spec fixes (spec/mcp-client.mdx):
- Remove icon: "plug" (no other tool mixins have icons)

Guide fixes (guides/mcp-client.mdx):
- Rename "For Team Projects" → "Example 1: Project-Level Config"
- Rename "For Personal Use" → "Example 2: User-Level Config"
- Remove team/personal labels from benefits section
- Remove manual _rebuild_system_prompt() calls (automated in Phase 1)
- Add comments about automatic system prompt updates

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

Removed sections (moved to SDK reference):
- Python SDK Examples (~100 lines) - Multiple code patterns
- Configuration (~58 lines) - Agent-level and global config

Kept sections:
- Complete Examples - Tutorial-style setup guide (recently cleaned up)

Result: 711 → 553 lines (trimmed 158 lines)

The guide now focuses on getting started, concepts, and step-by-step
tutorials. Detailed SDK patterns belong in docs/sdk/infrastructure/mcp-client.mdx.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

… Health agent

…tion

…o-any-mcp-server

…aia-agents-to-any-mcp-server' into 203-mcp-client-support-connect-gaia-agents-to-any-mcp-server

…structure

…ging

…t-connect-gaia-agents-to-any-mcp-server