# How to integrate DEV Community MCP with Mastra AI ```json { "title": "How to integrate DEV Community MCP with Mastra AI", "toolkit": "DEV Community", "toolkit_slug": "devto", "framework": "Mastra AI", "framework_slug": "mastra-ai", "url": "https://composio.dev/toolkits/devto/framework/mastra-ai", "markdown_url": "https://composio.dev/toolkits/devto/framework/mastra-ai.md", "updated_at": "2026-06-18T09:25:59.372Z" } ``` ## Introduction This guide walks you through connecting DEV Community to Mastra AI using the Composio tool router. By the end, you'll have a working DEV Community agent that can list your published dev articles, draft a tutorial post about docker, find trending javascript posts on dev through natural language commands. This guide will help you understand how to give your Mastra AI agent real control over a DEV Community account through Composio's DEV Community MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved. ## Also integrate DEV Community with - [OpenAI Agents SDK](https://composio.dev/toolkits/devto/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/devto/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/devto/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/devto/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/devto/framework/codex) - [OpenClaw](https://composio.dev/toolkits/devto/framework/openclaw) - [Hermes](https://composio.dev/toolkits/devto/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/devto/framework/cli) - [Google ADK](https://composio.dev/toolkits/devto/framework/google-adk) - [LangChain](https://composio.dev/toolkits/devto/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/devto/framework/ai-sdk) - [LlamaIndex](https://composio.dev/toolkits/devto/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/devto/framework/crew-ai) ## TL;DR Here's what you'll learn: - Set up your environment so Mastra, OpenAI, and Composio work together - Create a Tool Router session in Composio that exposes DEV Community tools - Connect Mastra's MCP client to the Composio generated MCP URL - Fetch DEV Community tool definitions and attach them as a toolset - Build a Mastra agent that can reason, call tools, and return structured results - Run an interactive CLI where you can chat with your DEV Community agent ## What is Mastra AI? Mastra AI is a TypeScript framework for building AI agents with tool support. It provides a clean API for creating agents that can use external services through MCP. Key features include: - MCP Client: Built-in support for Model Context Protocol servers - Toolsets: Organize tools into logical groups - Step Callbacks: Monitor and debug agent execution - OpenAI Integration: Works with OpenAI models via @ai-sdk/openai ## What is the DEV Community MCP server, and what's possible with it? The DEV Community MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your DEV Community account. It provides structured and secure access so your agent can perform DEV Community operations on your behalf. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `DEVTO_CREATE_ARTICLE` | Create Article | Create a new article on DEV Community. Use this action to create a new article on behalf of the authenticated user. The article can be published immediately by setting published=true, or saved as a draft by setting published=false (which is the default). Required fields are title and body_markdown. Optional fields include description, main_image, tags, series, canonical_url, and organization_id. | | `DEVTO_GET_ARTICLE` | Get Article By ID | Returns a single published article by its ID, including full body content. Use this action when you know the unique ID of the article you want to retrieve. The response includes complete article details such as title, full HTML and markdown body content, author information, reaction counts, comments count, and reading time. | | `DEVTO_GET_ARTICLE_BY_PATH` | Get Article By Path | Returns a single published article by username and slug path. Use this action when you know the username of the author and the article's slug. The response includes full article details including title, content, author info, reactions count, comments count, and reading time. | | `DEVTO_GET_COMMENT` | Get Comment by ID | Returns a single comment and its descendants (replies) by comment ID. Use this action when you need to retrieve a specific comment along with all its replies from DEV Community. The response includes the comment content, author information, and nested child comments. Note: The comment ID is the id_code field (e.g., "1", "32k5a"), not the numeric user_id. | | `DEVTO_GET_CURRENT_USER` | Get Current User | Tool to get the currently authenticated user's profile information. Use when you need to retrieve the profile of the user associated with the provided API key. Returns user details including username, name, bio, location, and profile image. | | `DEVTO_GET_LISTING` | Get Listing | Returns a single classified listing by its ID. Use this action to retrieve detailed information about a specific listing on DEV Community, including the title, description, category, tags, and information about the user who posted it. | | `DEVTO_GET_ORGANIZATION` | Get Organization | Returns a single organization by its username. Use this action when you need to retrieve organization profile information from DEV Community. Returns organization details including name, summary, social links, and profile image. | | `DEVTO_GET_PROFILE_IMAGE` | Get Profile Image | Returns the profile image URL for a user or organization by username. Use this action to retrieve the profile picture(s) for a specific user or organization on DEV Community. The API returns both the full-size image URL and a 90px thumbnail. | | `DEVTO_GET_USER` | Get user | Tool to get a single user by their ID or username. Use when you need to retrieve user profile information from DEV Community. Returns user details including username, name, bio, location, and profile image. | | `DEVTO_LIST_ARTICLES` | List Articles | Returns a list of published articles, optionally filtered by tags, username, state, or top articles. Supports pagination. Use when you need to browse or search for articles on DEV Community. Examples: - Get latest articles: omit all filters - Get articles by tag: set tag="javascript" - Get top articles: set state="all" and top=7 - Get rising articles: set state="rising" - Get articles from user: set username="ben" | | `DEVTO_LIST_COMMENTS` | List Comments | Tool to list comments for a specified article or podcast episode on DEV Community. Use when you need to retrieve all comments for a particular article or podcast episode. Requires either a_id (article ID) or p_id (podcast episode ID) parameter. | | `DEVTO_LIST_FOLLOWED_TAGS` | List Followed Tags | Returns a list of tags followed by the authenticated user. Use this action to retrieve the tags that the currently authenticated user has followed on DEV.to. The response includes the tag ID, name, and points. | | `DEVTO_LIST_FOLLOWERS` | List Followers | Tool to retrieve a list of users who follow the authenticated user. Supports pagination with 80 followers per page by default. Use when you need to see who is following the authenticated user's profile. | | `DEVTO_LIST_LATEST_ARTICLES` | List latest DEV Community articles | Tool to retrieve a list of published articles sorted by descending publish date. Use when you need to fetch the latest articles from DEV Community with pagination support. Returns articles with full details including author info, tags, and engagement metrics. | | `DEVTO_LIST_LISTINGS` | List Listings | Returns a list of classified listings for jobs, mentors, products, etc. Use this action to browse available listings on DEV Community. Supports pagination and filtering by category to find specific types of listings (jobs, mentors, events, etc.). | | `DEVTO_LIST_LISTINGS_BY_CATEGORY` | List Listings By Category | Returns a list of classified listings filtered by category. Use this action to browse listings on DEV Community for a specific category (jobs, mentors, products, events, etc.). The category is a required path parameter. Supports pagination via page and per_page parameters. | | `DEVTO_LIST_ORGANIZATION_ARTICLES` | List Organization Articles | Tool to list articles published by a specific organization on DEV.to. Use when you need to retrieve all articles published by an organization. The results are paginated and can be filtered by page number and items per page. | | `DEVTO_LIST_ORGANIZATION_USERS` | List organization users on DEV.to | Tool to list users belonging to a specified organization on DEV.to. Use when you need to retrieve all members/users of a particular organization. Returns a list of user objects with their profile information including username, name, profile image, and social links. | | `DEVTO_LIST_PODCAST_EPISODES` | List podcast episodes on DEV.to | Tool to retrieve a list of podcast episodes from DEV.to. Use when you need to browse or search for podcast episodes on DEV.to. Returns a list of podcast episodes, optionally filtered by podcast username. Supports pagination to navigate through large result sets. | | `DEVTO_LIST_READING_LIST` | List DEVTO Reading List | Returns the articles in the authenticated user's reading list. Requires authentication via API key. The reading list contains articles that the authenticated user has saved for later reading. | | `DEVTO_LIST_TAGS` | List Tags | Returns a list of tags with their names, background colors, and text colors. Use this action to retrieve available tags from DEV Community for filtering articles or discovering topics. Supports pagination to handle large numbers of tags. | | `DEVTO_LIST_USER_ALL_ARTICLES` | List User All Articles | Tool to list all articles (both published and unpublished) for the authenticated user. Use when you need to retrieve all articles belonging to the authenticated user's account, including draft and unpublished articles. | | `DEVTO_LIST_USER_ARTICLES` | List User Articles | Tool to list published articles for the authenticated user. Use when you need to retrieve only the published articles belonging to the authenticated user's account. For unpublished/draft articles, use the List User All Articles action instead. | | `DEVTO_LIST_USER_PUBLISHED_ARTICLES` | List user's published articles | Returns a list of the authenticated user's published articles only. Use when you need to retrieve articles that the current user has published on DEV Community. Supports pagination via page and per_page parameters. | | `DEVTO_LIST_USER_UNPUBLISHED_ARTICLES` | List user's unpublished articles | Returns a list of the authenticated user's unpublished (draft) articles. Use when you need to retrieve draft articles that have not yet been published. Supports pagination via page and per_page parameters. | | `DEVTO_LIST_VIDEOS` | List Videos | Tool to retrieve a list of articles that contain videos. Use when you need to browse video content on DEV Community. Supports pagination via page and per_page parameters. | | `DEVTO_UPDATE_ARTICLE` | Update Article | Update an existing article on DEV Community. Only the article owner can update it. Use this action to modify article properties like title, body content, description, cover image, tags, and publication status. Only provide the fields you want to update. | | `DEVTO_UPDATE_LISTING` | Update Listing | Updates an existing classified listing on DEV Community. Use this action to modify a listing's title, body, category, tags, or status. The 'bump' action refreshes the listing's timestamp, 'publish' sets it to published, and 'unpublish' sets it to unpublished. Requires API key authentication. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The DEV Community MCP server is an implementation of the Model Context Protocol that connects your AI agent to DEV Community. It provides structured and secure access so your agent can perform DEV Community operations on your behalf through a secure, permission-based interface. With Composio's managed implementation, you don't have to create your own developer app. For production, if you're building an end product, we recommend using your own credentials. The managed server helps you prototype fast and go from 0-1 faster. ## Step-by-step Guide ### 1. Prerequisites Before starting, make sure you have: - Node.js 18 or higher - A Composio account with an active API key - An OpenAI API key - Basic familiarity with TypeScript ### 1. Getting API Keys for OpenAI and Composio OpenAI API Key - Go to the [OpenAI dashboard](https://platform.openai.com/settings/organization/api-keys) and create an API key. - You need credits or a connected billing setup to use the models. - Store the key somewhere safe. Composio API Key - Log in to the [Composio dashboard](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs). - Go to Settings and copy your API key. - This key lets your Mastra agent talk to Composio and reach DEV Community through MCP. ### 2. Install dependencies Install the required packages. What's happening: - @composio/core is the Composio SDK for creating MCP sessions - @mastra/core provides the Agent class - @mastra/mcp is Mastra's MCP client - @ai-sdk/openai is the model wrapper for OpenAI - dotenv loads environment variables from .env ```bash npm install @composio/core @mastra/core @mastra/mcp @ai-sdk/openai dotenv ``` ### 3. Set up environment variables Create a .env file in your project root. What's happening: - COMPOSIO_API_KEY authenticates your requests to Composio - COMPOSIO_USER_ID tells Composio which user this session belongs to - OPENAI_API_KEY lets the Mastra agent call OpenAI models ```bash COMPOSIO_API_KEY=your_composio_api_key_here COMPOSIO_USER_ID=your_user_id_here OPENAI_API_KEY=your_openai_api_key_here ``` ### 4. Import libraries and validate environment What's happening: - dotenv/config auto loads your .env so process.env.* is available - openai gives you a Mastra compatible model wrapper - Agent is the Mastra agent that will call tools and produce answers - MCPClient connects Mastra to your Composio MCP server - Composio is used to create a Tool Router session ```typescript import "dotenv/config"; import { openai } from "@ai-sdk/openai"; import { Agent } from "@mastra/core/agent"; import { MCPClient } from "@mastra/mcp"; import { Composio } from "@composio/core"; import * as readline from "readline"; import type { AiMessageType } from "@mastra/core/agent"; const openaiAPIKey = process.env.OPENAI_API_KEY; const composioAPIKey = process.env.COMPOSIO_API_KEY; const composioUserID = process.env.COMPOSIO_USER_ID; if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set"); if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set"); if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set"); const composio = new Composio({ apiKey: composioAPIKey as string, }); ``` ### 5. Create a Tool Router session for DEV Community What's happening: - create spins up a short-lived MCP HTTP endpoint for this user - The toolkits array contains "devto" for DEV Community access - session.mcp.url is the MCP URL that Mastra's MCPClient will connect to ```typescript async function main() { const session = await composio.create( composioUserID as string, { toolkits: ["devto"], }, ); const composioMCPUrl = session.mcp.url; console.log("DEV Community MCP URL:", composioMCPUrl); ``` ### 6. Configure Mastra MCP client and fetch tools What's happening: - MCPClient takes an id for this client and a list of MCP servers - The headers property includes the x-api-key for authentication - getTools fetches the tool definitions exposed by the DEV Community toolkit ```typescript const mcpClient = new MCPClient({ id: composioUserID as string, servers: { nasdaq: { url: new URL(composioMCPUrl), requestInit: { headers: session.mcp.headers, }, }, }, timeout: 30_000, }); console.log("Fetching MCP tools from Composio..."); const composioTools = await mcpClient.getTools(); console.log("Number of tools:", Object.keys(composioTools).length); ``` ### 7. Create the Mastra agent What's happening: - Agent is the core Mastra agent - name is just an identifier for logging and debugging - instructions guide the agent to use tools instead of only answering in natural language - model uses openai("gpt-5") to configure the underlying LLM ```typescript const agent = new Agent({ name: "devto-mastra-agent", instructions: "You are an AI agent with DEV Community tools via Composio.", model: "openai/gpt-5", }); ``` ### 8. Set up interactive chat interface What's happening: - messages keeps the full conversation history in Mastra's expected format - agent.generate runs the agent with conversation history and DEV Community toolsets - maxSteps limits how many tool calls the agent can take in a single run - onStepFinish is a hook that prints intermediate steps for debugging ```typescript let messages: AiMessageType[] = []; console.log("Chat started! Type 'exit' or 'quit' to end.\n"); const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: "> ", }); rl.prompt(); rl.on("line", async (userInput: string) => { const trimmedInput = userInput.trim(); if (["exit", "quit", "bye"].includes(trimmedInput.toLowerCase())) { console.log("\nGoodbye!"); rl.close(); process.exit(0); } if (!trimmedInput) { rl.prompt(); return; } messages.push({ id: crypto.randomUUID(), role: "user", content: trimmedInput, }); console.log("\nAgent is thinking...\n"); try { const response = await agent.generate(messages, { toolsets: { devto: composioTools, }, maxSteps: 8, }); const { text } = response; if (text && text.trim().length > 0) { console.log(`Agent: ${text}\n`); messages.push({ id: crypto.randomUUID(), role: "assistant", content: text, }); } } catch (error) { console.error("\nError:", error); } rl.prompt(); }); rl.on("close", async () => { console.log("\nSession ended."); await mcpClient.disconnect(); process.exit(0); }); } main().catch((err) => { console.error("Fatal error:", err); process.exit(1); }); ``` ## Complete Code ```typescript import "dotenv/config"; import { openai } from "@ai-sdk/openai"; import { Agent } from "@mastra/core/agent"; import { MCPClient } from "@mastra/mcp"; import { Composio } from "@composio/core"; import * as readline from "readline"; import type { AiMessageType } from "@mastra/core/agent"; const openaiAPIKey = process.env.OPENAI_API_KEY; const composioAPIKey = process.env.COMPOSIO_API_KEY; const composioUserID = process.env.COMPOSIO_USER_ID; if (!openaiAPIKey) throw new Error("OPENAI_API_KEY is not set"); if (!composioAPIKey) throw new Error("COMPOSIO_API_KEY is not set"); if (!composioUserID) throw new Error("COMPOSIO_USER_ID is not set"); const composio = new Composio({ apiKey: composioAPIKey as string }); async function main() { const session = await composio.create(composioUserID as string, { toolkits: ["devto"], }); const composioMCPUrl = session.mcp.url; const mcpClient = new MCPClient({ id: composioUserID as string, servers: { devto: { url: new URL(composioMCPUrl), requestInit: { headers: session.mcp.headers, }, }, }, timeout: 30_000, }); const composioTools = await mcpClient.getTools(); const agent = new Agent({ name: "devto-mastra-agent", instructions: "You are an AI agent with DEV Community tools via Composio.", model: "openai/gpt-5", }); let messages: AiMessageType[] = []; const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: "> ", }); rl.prompt(); rl.on("line", async (input: string) => { const trimmed = input.trim(); if (["exit", "quit"].includes(trimmed.toLowerCase())) { rl.close(); return; } messages.push({ id: crypto.randomUUID(), role: "user", content: trimmed }); const { text } = await agent.generate(messages, { toolsets: { devto: composioTools }, maxSteps: 8, }); if (text) { console.log(`Agent: ${text}\n`); messages.push({ id: crypto.randomUUID(), role: "assistant", content: text }); } rl.prompt(); }); rl.on("close", async () => { await mcpClient.disconnect(); process.exit(0); }); } main(); ``` ## Conclusion You've built a Mastra AI agent that can interact with DEV Community through Composio's Tool Router. You can extend this further by: - Adding other toolkits like Gmail, Slack, or GitHub - Building a web-based chat interface around this agent - Using multiple MCP endpoints to enable cross-app workflows ## How to build DEV Community MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/devto/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/devto/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/devto/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/devto/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/devto/framework/codex) - [OpenClaw](https://composio.dev/toolkits/devto/framework/openclaw) - [Hermes](https://composio.dev/toolkits/devto/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/devto/framework/cli) - [Google ADK](https://composio.dev/toolkits/devto/framework/google-adk) - [LangChain](https://composio.dev/toolkits/devto/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/devto/framework/ai-sdk) - [LlamaIndex](https://composio.dev/toolkits/devto/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/devto/framework/crew-ai) ## Related Toolkits - [Twitter](https://composio.dev/toolkits/twitter) - Twitter is a social media platform for sharing real-time updates, conversations, and news. Stay connected, informed, and engaged with communities worldwide. - [Instagram](https://composio.dev/toolkits/instagram) - Instagram is a social platform for sharing photos, videos, and stories with your audience. It helps brands and creators engage, grow, and analyze their online presence. - [Ayrshare](https://composio.dev/toolkits/ayrshare) - Ayrshare is a Social Media API for managing, automating, and analyzing posts across multiple platforms. It helps you streamline social media workflows and centralize analytics. - [Dotsimple](https://composio.dev/toolkits/dotsimple) - Dotsimple is a social media management platform for planning, creating, and publishing content. It helps teams boost their reach with AI-powered content generation and actionable analytics. - [Strava](https://composio.dev/toolkits/strava) - Strava is a social fitness network and app for cyclists and runners. It's perfect for tracking workouts, sharing progress, and joining active communities. - [Tiktok](https://composio.dev/toolkits/tiktok) - Tiktok is a short-form video platform for creating, sharing, and discovering viral content. It helps creators and brands reach massive audiences with creative tools and global social features. - [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable. - [Google Calendar](https://composio.dev/toolkits/googlecalendar) - Google Calendar is a time management service for scheduling meetings, events, and reminders. It streamlines personal and team organization with integrated notifications and sharing options. - [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices. - [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management. - [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly. - [Supabase](https://composio.dev/toolkits/supabase) - Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure. - [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed. - [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place. - [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place. - [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations. - [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze. - [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization. - [Hubspot](https://composio.dev/toolkits/hubspot) - HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place. - [Codeinterpreter](https://composio.dev/toolkits/codeinterpreter) - Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and DEV Community MCP? With a standalone DEV Community MCP server, the agents and LLMs can only access a fixed set of DEV Community tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from DEV Community and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Mastra AI? Yes, you can. Mastra AI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right DEV Community tools. ### Can I manage the permissions and scopes for DEV Community while using Tool Router? Yes, absolutely. You can configure which DEV Community scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your DEV Community data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)