McpPlug (Python)

Built for LoopEngine — a runtime for defining and running AI agents through a transparent ReAct loop — as a ToolSource wrapping Composio's 1000+ app gateway behind the same ToolDefinition shape LoopEngine agents already use. Works standalone too, no dependency on LoopEngine itself.

Ported line-for-line from the TypeScript implementation. See the root README for the pitch and the scope decisions — this file only covers what's specific to running the Python code.

Install

pip install -e ".[dev]"

Quickstart

Requires the composio CLI installed and authenticated (composio link <toolkit>) for whichever tools you list.

from mcpplug import ComposioSourceOptions, connect_composio_source

github = await connect_composio_source(
    "gh", ComposioSourceOptions(slugs=["GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER"])
)

tools = await github.load_tools()
# -> [ToolDefinition(name='gh_GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER', ...)]

result = await tools[0].execute({"per_page": 5})

Merge tools into any agent's tool list — each ToolDefinition is the same shape a loopengine-style AgentConfig.tools expects.

Test

pytest

Status

The ToolSource protocol and the Composio-backed source are real and tested (tests/test_composio_source.py uses a stand-in CLI script, not a live network call). Not yet published to PyPI.