Composiohq Composio Building Agents Using Mastra

Building Agents using Mastra with Composio

Build AI agents using Mastra with Composio Tool Router.

Installation

npm install @composio/core @composio/mastra @mastra/core

Find Latest Versions:

npm view @mastra/core version
npm view @composio/mastra version

Integration Method

Mastra is an agentic provider - use Tool Router for user isolation.

Native Tools with Tool Router

import { Composio } from '@composio/core';
import { MastraProvider } from '@composio/mastra';
import { Agent } from '@mastra/core/agent';

const composio = new Composio({
  apiKey: process.env.COMPOSIO_API_KEY,
  provider: new MastraProvider(),
});

async function createAgent(userId: string) {
  // Create session
  const session = await composio.create(userId, {
    toolkits: ['github'],
    manageConnections: true
  });

  const tools = await session.tools();

  // Create agent
  const agent = new Agent({
    id: 'github-agent',
    name: 'GitHub Agent',
    instructions: 'You manage GitHub repositories',
    model: 'openai/gpt-4o',
    tools: {
      ...tools,  // Spread Composio tools
    },
  });

  return agent;
}

const agent = await createAgent('user_123');
const result = await agent.generate({
  prompt: 'Create a GitHub issue titled "Bug Report"',
});

console.log(result.text);

Streaming with Tool Router

async function streamAgent(userId: string, prompt: string) {
  const session = await composio.create(userId, {
    toolkits: ['github'],
    manageConnections: true
  });

  const tools = await session.tools();

  const agent = new Agent({
    id: 'agent',
    model: 'openai/gpt-4o',
    tools: { ...tools },
    maxSteps: 10,
  });

  // Stream response
  const stream = await agent.stream({
    prompt,
    onStepFinish: (step) => {
      console.log('Step completed:', step);
    },
  });

  for await (const chunk of stream) {
    process.stdout.write(chunk);
  }
}

Key Features

• 40+ Model Providers: OpenAI, Anthropic, Google, Mistral, Groq, etc.
• Autonomous Agents: Solve open-ended tasks
• Streaming Support: Real-time responses
• v1.0 Released: January 2026 - production ready

Key Resources

• Mastra Docs: https://mastra.ai/docs
• Tool Router Guide: /building-agents
• Agents Guide: https://mastra.ai/docs/agents/overview
• GitHub: https://github.com/mastra-ai/mastra

Environment Variables

OPENAI_API_KEY=sk-...  # Or other model provider
COMPOSIO_API_KEY=...

Next Steps

1. Use /building-agents for comprehensive guide
2. Check ts/examples/mastra/ for complete examples
3. See Mastra docs for multi-provider routing