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
BrowserKing: Open-Source Chrome Extension for Browser Control via Claude and Other Models
BrowserKing is a free, open-source Chrome extension that lets Claude and 15+ other models see and control your browser from a side panel. It takes screenshots, sends them to the model, and then acts on decisions to click buttons, fill forms, scroll, and navigate tabs.
ClaudeClaw: Free Claude Code Plugin for Persistent AI Agents on Messaging Platforms
ClaudeClaw is a free, open-source MIT-licensed Claude Code plugin that runs Claude as a persistent agent on Slack, WhatsApp, and Telegram. It requires Node.js 20+, Claude Code, and your own Anthropic API key, with OS-level sandbox isolation via Anthropic's sandbox-runtime.
InsForge: Self-Hosted Postgres Backend with MCP Integration for AI Coding Agents
InsForge is an open-source, self-hosted backend alternative to Supabase that connects to Claude Code via MCP, allowing AI agents to see schema, policies, and service state. It includes PostgreSQL 16.4, PostgREST, Deno Runtime, auth, storage, and edge functions.
Council: A Structured Dialogue Framework for Claude
Council — A Crucible is a structured dialogue framework that runs inside a single Claude context window, using persona framing to produce four distinct modes of engagement: rigorous interrogation, generative action, lived experience, and unformed intuition.