# How to integrate DEV Community MCP with Pydantic AI ```json { "title": "How to integrate DEV Community MCP with Pydantic AI", "toolkit": "DEV Community", "toolkit_slug": "devto", "framework": "Pydantic AI", "framework_slug": "pydantic-ai", "url": "https://composio.dev/toolkits/devto/framework/pydantic-ai", "markdown_url": "https://composio.dev/toolkits/devto/framework/pydantic-ai.md", "updated_at": "2026-06-18T09:25:59.372Z" } ``` ## Introduction This guide walks you through connecting DEV Community to Pydantic 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 Pydantic 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) - [Mastra AI](https://composio.dev/toolkits/devto/framework/mastra-ai) - [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: - How to set up your Composio API key and User ID - How to create a Composio Tool Router session for DEV Community - How to attach an MCP Server to a Pydantic AI agent - How to stream responses and maintain chat history - How to build a simple REPL-style chat interface to test your DEV Community workflows ## What is Pydantic AI? Pydantic AI is a Python framework for building AI agents with strong typing and validation. It leverages Pydantic's data validation capabilities to create robust, type-safe AI applications. Key features include: - Type Safety: Built on Pydantic for automatic data validation - MCP Support: Native support for Model Context Protocol servers - Streaming: Built-in support for streaming responses - Async First: Designed for async/await patterns ## 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: - Python 3.9 or higher - A Composio account with an active API key - Basic familiarity with Python and async programming ### 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'll need credits to use the models, or you can connect to another model provider. - Keep the API key safe. Composio API Key - Log in to the [Composio dashboard](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs). - Navigate to your API settings and generate a new API key. - Store this key securely as you'll need it for authentication. ### 2. Install dependencies Install the required libraries. What's happening: - composio connects your agent to external SaaS tools like DEV Community - pydantic-ai lets you create structured AI agents with tool support - python-dotenv loads your environment variables securely from a .env file ```bash pip install composio pydantic-ai python-dotenv ``` ### 3. Set up environment variables Create a .env file in your project root. What's happening: - COMPOSIO_API_KEY authenticates your agent to Composio's API - USER_ID associates your session with your account for secure tool access - OPENAI_API_KEY to access OpenAI LLMs ```bash COMPOSIO_API_KEY=your_composio_api_key_here USER_ID=your_user_id_here OPENAI_API_KEY=your_openai_api_key ``` ### 4. Import dependencies What's happening: - We load environment variables and import required modules - Composio manages connections to DEV Community - MCPServerStreamableHTTP connects to the DEV Community MCP server endpoint - Agent from Pydantic AI lets you define and run the AI assistant ```python import asyncio import os from dotenv import load_dotenv from composio import Composio from pydantic_ai import Agent from pydantic_ai.mcp import MCPServerStreamableHTTP load_dotenv() ``` ### 5. Create a Tool Router Session What's happening: - We're creating a Tool Router session that gives your agent access to DEV Community tools - The create method takes the user ID and specifies which toolkits should be available - The returned session.mcp.url is the MCP server URL that your agent will use ```python async def main(): api_key = os.getenv("COMPOSIO_API_KEY") user_id = os.getenv("USER_ID") if not api_key or not user_id: raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment") # Create a Composio Tool Router session for DEV Community composio = Composio(api_key=api_key) session = composio.create( user_id=user_id, toolkits=["devto"], ) url = session.mcp.url if not url: raise ValueError("Composio session did not return an MCP URL") ``` ### 6. Initialize the Pydantic AI Agent What's happening: - The MCP client connects to the DEV Community endpoint - The agent uses GPT-5 to interpret user commands and perform DEV Community operations - The instructions field defines the agent's role and behavior ```python # Attach the MCP server to a Pydantic AI Agent devto_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY}) agent = Agent( "openai:gpt-5", toolsets=[devto_mcp], instructions=( "You are a DEV Community assistant. Use DEV Community tools to help users " "with their requests. Ask clarifying questions when needed." ), ) ``` ### 7. Build the chat interface What's happening: - The agent reads input from the terminal and streams its response - DEV Community API calls happen automatically under the hood - The model keeps conversation history to maintain context across turns ```python # Simple REPL with message history history = [] print("Chat started! Type 'exit' or 'quit' to end.\n") print("Try asking the agent to help you with DEV Community.\n") while True: user_input = input("You: ").strip() if user_input.lower() in {"exit", "quit", "bye"}: print("\nGoodbye!") break if not user_input: continue print("\nAgent is thinking...\n", flush=True) async with agent.run_stream(user_input, message_history=history) as stream_result: collected_text = "" async for chunk in stream_result.stream_output(): text_piece = None if isinstance(chunk, str): text_piece = chunk elif hasattr(chunk, "delta") and isinstance(chunk.delta, str): text_piece = chunk.delta elif hasattr(chunk, "text"): text_piece = chunk.text if text_piece: collected_text += text_piece result = stream_result print(f"Agent: {collected_text}\n") history = result.all_messages() ``` ### 8. Run the application What's happening: - The asyncio loop launches the agent and keeps it running until you exit ```python if __name__ == "__main__": asyncio.run(main()) ``` ## Complete Code ```python import asyncio import os from dotenv import load_dotenv from composio import Composio from pydantic_ai import Agent from pydantic_ai.mcp import MCPServerStreamableHTTP load_dotenv() async def main(): api_key = os.getenv("COMPOSIO_API_KEY") user_id = os.getenv("USER_ID") if not api_key or not user_id: raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment") # Create a Composio Tool Router session for DEV Community composio = Composio(api_key=api_key) session = composio.create( user_id=user_id, toolkits=["devto"], ) url = session.mcp.url if not url: raise ValueError("Composio session did not return an MCP URL") # Attach the MCP server to a Pydantic AI Agent devto_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY}) agent = Agent( "openai:gpt-5", toolsets=[devto_mcp], instructions=( "You are a DEV Community assistant. Use DEV Community tools to help users " "with their requests. Ask clarifying questions when needed." ), ) # Simple REPL with message history history = [] print("Chat started! Type 'exit' or 'quit' to end.\n") print("Try asking the agent to help you with DEV Community.\n") while True: user_input = input("You: ").strip() if user_input.lower() in {"exit", "quit", "bye"}: print("\nGoodbye!") break if not user_input: continue print("\nAgent is thinking...\n", flush=True) async with agent.run_stream(user_input, message_history=history) as stream_result: collected_text = "" async for chunk in stream_result.stream_output(): text_piece = None if isinstance(chunk, str): text_piece = chunk elif hasattr(chunk, "delta") and isinstance(chunk.delta, str): text_piece = chunk.delta elif hasattr(chunk, "text"): text_piece = chunk.text if text_piece: collected_text += text_piece result = stream_result print(f"Agent: {collected_text}\n") history = result.all_messages() if __name__ == "__main__": asyncio.run(main()) ``` ## Conclusion You've built a Pydantic AI agent that can interact with DEV Community through Composio's Tool Router. With this setup, your agent can perform real DEV Community actions through natural language. You can extend this further by: - Adding other toolkits like Gmail, HubSpot, or Salesforce - Building a web-based chat interface around this agent - Using multiple MCP endpoints to enable cross-app workflows (for example, Gmail + DEV Community for workflow automation) This architecture makes your AI agent "agent-native", able to securely use APIs in a unified, composable way without custom integrations. ## 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) - [Mastra AI](https://composio.dev/toolkits/devto/framework/mastra-ai) - [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 Pydantic AI? Yes, you can. Pydantic 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)