McpPlug (TypeScript)

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.

See the root README for the pitch and the scope decisions. This file only covers what's specific to running the code.

Install

npm install

Quickstart

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

import { connectComposioSource } from './src/index.js'

const github = await connectComposioSource('gh', {
  slugs: ['GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER'],
})

const tools = await github.loadTools()
// -> [{ name: 'gh_GITHUB_LIST_REPOSITORIES_FOR_THE_AUTHENTICATED_USER', ... }]

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

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

Test / build

npm test        # vitest
npm run build   # tsc -> dist/

Status

The ToolSource interface and the Composio-backed source are real and tested (tests/composio-source.test.ts uses a stand-in CLI script, not a live network call). Not yet published to npm.