MCP Tools

What is MCP?

MCP (Model Context Protocol) is an open protocol that enables AI models to connect to external data sources and tools through a standardized interface. It allows agents to dynamically discover and use tools exposed by MCP servers.

Current Status

MindRoom includes the mcp library as a dependency, but direct MCP server configuration in agent YAML is not yet supported. The underlying Agno framework provides MCPTools and MultiMCPTools classes that MindRoom plans to integrate in a future release.

Planned Features

When implemented, MCP support will allow:

• Connecting to external MCP servers (filesystem, GitHub, databases, etc.)
• Automatic tool discovery from MCP server capabilities
• Support for stdio, SSE, and Streamable HTTP transports

Workaround: Using Agno MCPTools Directly

Until native MindRoom configuration is available, you can use MCP tools through a custom plugin. The key is to create a subclass that pre-configures the MCP server parameters, since MindRoom's tool registry expects a class (not an instance).

Plugin Structure

Create a plugin directory with the following structure:

plugins/
└── mcp-filesystem/
    ├── mindroom.plugin.json
    └── tools.py

mindroom.plugin.json:

{
  "name": "mcp-filesystem",
  "tools_module": "tools.py",
  "skills": []
}

tools.py:

from agno.tools.mcp import MCPTools
from mindroom.tools_metadata import register_tool_with_metadata, ToolCategory, ToolStatus, SetupType


class FilesystemMCPTools(MCPTools):
    """Pre-configured MCPTools for filesystem access."""

    def __init__(self, **kwargs):
        super().__init__(
            command="npx -y @modelcontextprotocol/server-filesystem /path/to/dir",
            **kwargs,
        )


@register_tool_with_metadata(
    name="my_mcp_server",
    display_name="My MCP Server",
    description="Tools from my custom MCP server",
    category=ToolCategory.DEVELOPMENT,
    status=ToolStatus.AVAILABLE,
    setup_type=SetupType.NONE,
)
def my_mcp_tools():
    """Return the MCPTools subclass (not an instance)."""
    return FilesystemMCPTools

Configuration

Reference the plugin directory in your config.yaml:

plugins:
  - ./plugins/mcp-filesystem

agents:
  assistant:
    display_name: Assistant
    tools:
      - my_mcp_server