Brain-MCP Developer Documents Tools for Claude AI Instead of Humans
A developer maintaining the Brain-MCP server, which gives Claude memory across conversations, discovered that the primary consumer of their documentation was Claude rather than human GitHub readers. They added a "For AI Assistants" section at the top of the README containing behavioral instructions rather than just tool descriptions.
Key Details from the Experiment
The developer created a dedicated page at brainmcp.dev/for-ai with specific guidance for AI assistants. The behavioral instructions in the README function like a system prompt for tool usage.
The immediate difference observed was that Claude started using tools more intelligently—not just when explicitly asked, but proactively injecting relevant context when the user switched topics.
Documentation Pattern for AI Consumption
The developer suggests that if your MCP server is consumed by an AI, you should write documentation specifically for the AI. This includes:
- Not just tool names and parameter types
- Actual guidance on when and how to use tools effectively
- Behavioral instructions that influence how Claude uses the tools
Specific Examples from the Documentation
The documentation includes practical guidance such as:
- When to proactively search (e.g., when user says "where did I leave off" → call tunnel_state)
- How to present results ("synthesize, don't dump raw search results")
- When NOT to search (pure commands, continuation of same thread)
Technical Details
The Brain-MCP server can be installed with: pipx install brain-mcp && brain-mcp setup
The project includes 25 tools, is 100% local, and is MIT licensed.
The developer is asking other MCP developers if they've experimented with similar approaches to influence how Claude uses their tools beyond basic tool descriptions.
📖 Read the full source: r/ClaudeAI
👀 See Also
Deblank: Tool to Strip Code Formatting for LLM Token Reduction
Deblank is an open-source tool that strips code formatting (indentation, whitespace, line breaks) before sending to LLMs, reducing tokens by ~30% for Java/C++ and ~9% for Python with ~76ms latency. It supports Python, Java, C/C++, C#, JS/TS, and Go.
Bypassing NemoClaw Sandbox Isolation for Local Nemotron 9B Agent
A developer bypassed NemoClaw's sandbox isolation to run a fully local agent using Nemotron 9B with tool calling on a single RTX 5090. The approach involved iptables configuration, a custom TCP relay, and real-time tool call translation.
Adam CAD Harness Integrates with Fusion and Onshape for Agentic CAD Editing
Adam’s agentic CAD harness now integrates with Autodesk Fusion and PTC Onshape, reading and editing feature trees via natural language. Install via one-liner commands for macOS/Windows.
Developer builds MCP server connecting 18 e-commerce tools to Claude
A developer created an MCP server that integrates 18 e-commerce platforms and tools with Claude, enabling cross-referencing queries across multiple data sources. The project was primarily built using Claude Code (Opus) in days rather than months.