Crowdin with OpenAI Agents SDK

How to integrate Crowdin MCP with OpenAI Agents SDK

Trusted by

GET STARTED FOR FREE GET A DEMO

30 min · no commitment · see it on your stack

Introduction Also integrate Crowdin with TL;DR What is OpenAI Agents SDK What is the Crowdin MCP server Supported Tools & Triggers Creating MCP Server - Stand-alone vs Composio SDK Step-by-step Guide Complete Code Conclusion How to build Crowdin MCP Agent with another framework Explore Other Toolkits FAQ

Connect Crowdin without Auth hassles

We manage OAuth, API Key, token refresh, and scopes, you just build.

Try for Free

Introduction

This guide walks you through connecting Crowdin to the OpenAI Agents SDK using the Composio tool router. By the end, you'll have a working Crowdin agent that can create a new crowdin project for our app, add new source file to the translations project, assign sprint label to specific string ids through natural language commands.

This guide will help you understand how to give your OpenAI Agents SDK agent real control over a Crowdin account through Composio's Crowdin MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Crowdin with

Claude Agent SDK Claude Code Claude Cowork Codex OpenClaw Hermes CLI Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI

TL;DR

Here's what you'll learn:

Get and set up your OpenAI and Composio API keys
Install the necessary dependencies
Initialize Composio and create a Tool Router session for Crowdin
Configure an AI agent that can use Crowdin as a tool
Run a live chat session where you can ask the agent to perform Crowdin operations

What is OpenAI Agents SDK?

The OpenAI Agents SDK is a lightweight framework for building AI agents that can use tools and maintain conversation state. It provides a simple interface for creating agents with hosted MCP tool support.

Key features include:

Hosted MCP Tools: Connect to external services through hosted MCP endpoints
SQLite Sessions: Persist conversation history across interactions
Simple API: Clean interface with Agent, Runner, and tool configuration
Streaming Support: Real-time response streaming for interactive applications

What is the Crowdin MCP server, and what's possible with it?

The Crowdin MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Crowdin account. It provides structured and secure access to your localization projects, so your agent can manage branches, organize files, label content, automate webhooks, and orchestrate translation workflows on your behalf.

Branch and project management: Easily have your agent create, delete, or organize Crowdin projects and branches to streamline new releases or features.
Dynamic file handling: Let your agent add new files to projects, ensuring your translation assets are always up to date and properly organized by branch or directory.
Labeling and content categorization: Direct your agent to create, assign, or remove labels on resources and strings, helping you segment and track translation tasks with precision.
Workflow automation with webhooks: Automate your translation process by having the agent set up or remove webhooks for real-time notifications and integrations.
Resource cleanup and maintenance: Empower your agent to delete obsolete branches, labels, webhooks, or entire projects, keeping your Crowdin workspace clean and focused.

Supported Tools & Triggers

Tools

Add BranchTool to create a new branch in a Crowdin project.

Add DirectoryTool to create a new directory in a Crowdin project.

Add FileTool to add a new file to a Crowdin project.

Add Glossary TermTool to add a new term to a Crowdin glossary.

Add LabelTool to create a new label in a Crowdin project.

Create Crowdin ProjectTool to create a new project in Crowdin.

Add Project File Format SettingsTool to add file format settings to a Crowdin project.

Add WebhookTool to create a new webhook in a Crowdin project.

Assign Label to StringsAssign a label to one or more source strings in a Crowdin project.

Build Project Directory TranslationTool to build translations for a specific directory in a Crowdin project.

Build Project File TranslationTool to build a project file translation in Crowdin.

Build Project TranslationTool to build project translation in Crowdin, generating downloadable translation files.

Cancel Project Translation BuildTool to cancel a project translation build in Crowdin.

Check Bundle Export StatusTool to check the status of a bundle export operation in Crowdin.

Check Glossary Export StatusTool to check the status of a glossary export operation.

Check Glossary Import StatusTool to check the status of a glossary import operation.

Check GraphQL Rate LimitTool to check GraphQL API rate limit status for Crowdin.

Check Project Report StatusTool to check report generation status in a Crowdin project.

Check Project Build StatusTool to check the status of a project translation build in Crowdin.

Check TM Export StatusTool to check Translation Memory export status in Crowdin.

Check TM Import StatusTool to check Translation Memory import status in Crowdin.

Check AI Report StatusTool to check the generation status of an AI report for a Crowdin user.

Clone AI PromptTool to clone an existing AI prompt in Crowdin.

Create GlossaryTool to create a new glossary in Crowdin.

Import GlossaryTool to import glossary terms from a file into a Crowdin glossary.

Create Custom LanguageTool to create a custom language in Crowdin.

Create MT TranslationsTool to translate strings using Crowdin's Machine Translation engine.

Create Project CommentTool to add a comment or issue to a string or file (asset) in a Crowdin project.

Add Project MemberTool to add members to a Crowdin project.

Add BundleTool to add a new bundle to a Crowdin project.

Add DistributionTool to create a new distribution in a Crowdin project.

Create Report Settings TemplateTool to create a report settings template in Crowdin.

Create Project Strings Exporter SettingsTool to add project strings exporter settings in Crowdin.

Create Project TaskTool to create a new task in a Crowdin project.

Create StringTool to add a new source string to a Crowdin project.

Create TM ImportTool to import a Translation Memory file into Crowdin.

Add Translation MemoryTool to create a new Translation Memory (TM) in Crowdin.

Create TM SegmentsTool to create translation memory segments in Crowdin.

Create TM Segment RecordsTool to create translation memory segment records in Crowdin.

Create Translation AlignmentTool to create translation alignment for a project.

Create AI PromptTool to create a new AI prompt in Crowdin.

Add AI SnippetTool to create an AI snippet in Crowdin.

Create User Report Settings TemplateTool to create a user report settings template in Crowdin.

Delete BranchTool to delete a specific branch from a Crowdin project.

Delete DirectoryTool to delete a specific directory from a Crowdin project.

Delete FileTool to delete a specific file from a Crowdin project.

Delete GlossaryTool to delete a glossary from Crowdin.

Delete Glossary ConceptTool to delete a concept from a Crowdin glossary.

Delete Glossary TermTool to delete a term from a Crowdin glossary.

Delete Glossary TermsTool to clear terms from a Crowdin glossary.

Delete LabelTool to delete the label identified by the specified label ID in a project.

Delete Custom LanguageTool to delete a custom language from Crowdin.

Delete ProjectTool to delete a Crowdin project by its ID.

Delete Project Comment AttachmentTool to delete an attachment from a string or asset comment in a Crowdin project.

Delete Project MemberTool to delete a member from a Crowdin project.

Delete BundleTool to delete a bundle from a Crowdin project.

Delete DistributionTool to delete a distribution from a Crowdin project.

Delete Project File Format SettingsTool to delete file format settings from a Crowdin project.

Delete Report Settings TemplateTool to delete a report settings template from a Crowdin project.

Delete ScreenshotTool to delete a screenshot from a Crowdin project.

Delete Project Strings Exporter SettingsTool to delete project strings exporter settings in Crowdin.

Delete Task Settings TemplateTool to delete a task settings template from a Crowdin project.

Delete Project TaskTool to delete a specific task from a Crowdin project.

Delete Project Task CommentTool to delete a specific comment from a project task.

Delete StorageTool to delete a storage from Crowdin.

Delete StringTool to delete a specific source string from a Crowdin project.

Delete Translation MemoryTool to delete a Translation Memory (TM) from Crowdin.

Delete TM SegmentTool to delete a specific translation memory segment from Crowdin.

Clear TM SegmentsTool to clear all segments from a Translation Memory in Crowdin.

Delete TM Segment RecordTool to delete a translation memory segment record in Crowdin.

Delete User AI PromptTool to delete an AI prompt for a specific user.

Delete User AI ProviderTool to delete an AI provider for a specific user.

Delete AI SnippetTool to delete an AI snippet from Crowdin.

Delete User Report Settings TemplateTool to delete a user report settings template from Crowdin.

Delete WebhookPermanently deletes a webhook from a Crowdin project.

Download FileTool to download a file from a Crowdin project.

Download Glossary ExportTool to download an exported glossary from Crowdin.

Download Bundle ExportTool to download an exported bundle from Crowdin.

Download Project ReportTool to download a generated project report from Crowdin.

Download Project Translation BuildTool to download a built project translation from Crowdin.

Download TM ExportTool to download an exported Translation Memory from Crowdin.

Download AI ReportTool to download an AI report from Crowdin.

Edit FileTool to update file details in a project.

Edit LabelTool to edit a label's title in a Crowdin project.

Edit ProjectTool to update project details using JSON-Patch.

Edit StringEdit a source string in a Crowdin project using JSON Patch operations.

Execute GraphQL QueryTool to execute GraphQL queries against the Crowdin GraphQL API.

Export GlossaryTool to initiate a glossary export operation in Crowdin.

Export BundleTool to initiate an asynchronous export operation for a bundle in Crowdin.

Export Project TranslationsTool to export project translations from Crowdin.

Export Project Task StringsTool to export strings from a project task in XLIFF format.

Export Translation MemoryTool to export Translation Memory (TM) from Crowdin.

Generate Project ReportTool to generate organization reports in Crowdin projects.

Generate AI Prompt Fine-Tuning DatasetTool to generate an AI prompt fine-tuning dataset from project or TM data.

Get BranchTool to retrieve details of a specific branch in a Crowdin project by its ID.

Get FileTool to retrieve detailed information about a specific file in a Crowdin project.

Get GlossaryTool to retrieve information about a specific glossary by its ID.

Get Glossary ConceptTool to retrieve a specific concept from a Crowdin glossary.

Get Glossary TermTool to retrieve a specific term from a Crowdin glossary.

Get LabelTool to retrieve information about the label identified by the specified label ID in a project.

Get LanguageTool to retrieve details of a specific language.

Get Member InfoTool to retrieve information about a project member.

Get MTTool to retrieve details of a specific Machine Translation engine.

Get ProjectTool to retrieve details of a specific Crowdin project.

Get Project AI SettingsTool to retrieve AI settings for a specific Crowdin project.

Get Branch ProgressTool to retrieve branch translation progress for all languages in a Crowdin project.

Get BundleTool to retrieve details of a specific bundle from a Crowdin project.

Get String/Asset CommentTool to retrieve a specific string or asset comment by its ID in a Crowdin project.

Get DirectoryTool to retrieve information about a specific directory in a Crowdin project.

Get Directory ProgressTool to get translation progress for all languages in a specific directory of a Crowdin project.

Get DistributionTool to retrieve details of a specific distribution in a Crowdin project.

Get Project File Format SettingsTool to retrieve file format settings for a specific project.

Get File ProgressTool to retrieve file translation progress for all languages in a Crowdin project.

Get File RevisionTool to retrieve details of a specific file revision in a Crowdin project.

Get Project ProgressTool to retrieve project translation progress for all languages in a Crowdin project.

Get Language ProgressTool to retrieve translation progress for a specific language across all files in a Crowdin project.

Get QA Checks Revalidation StatusTool to retrieve the status of a QA checks revalidation job.

Get Report Settings TemplateTool to retrieve a specific report settings template from Crowdin.

Get Project Strings Exporter SettingsTool to retrieve project strings exporter settings by ID.

Get Task Settings TemplateTool to retrieve a specific task settings template from a Crowdin project.

Get Project TaskTool to retrieve details of a specific task in a Crowdin project.

Get Project Task CommentTool to retrieve a specific task comment by its ID in a Crowdin project.

Get StorageTool to retrieve details of a specific file uploaded to Crowdin storage.

Get StringRetrieves detailed information about a specific source string in a Crowdin project.

Get Translation MemoryTool to retrieve information about a specific Translation Memory by its ID.

Get Authenticated UserTool to retrieve information about the currently authenticated user.

Get AI PromptTool to retrieve a specific AI prompt from Crowdin.

Get AI Prompt Fine-Tuning Dataset StatusTool to retrieve the generation status of an AI prompt fine-tuning dataset.

Get User AI ProviderTool to retrieve an AI provider for a specific user.

Get User AI SettingsTool to retrieve AI settings for a Crowdin user.

Get AI SnippetTool to retrieve an AI snippet from Crowdin.

Get User Report ArchiveTool to get a specific report archive for a Crowdin user.

Get User Report Settings TemplateTool to retrieve a user report settings template in Crowdin.

Get User Security LogTool to retrieve details of a specific security log entry for a user.

Get ViewerTool to retrieve information about the authenticated user via GraphQL.

Get WebhookRetrieves detailed information about a specific webhook in a Crowdin project.

List Application InstallationsList all application installations in Crowdin with pagination and filtering support.

List BranchesList all branches in a Crowdin project.

List FilesTool to list files in a Crowdin project.

List GlossariesTool to list all glossaries available to the authenticated user.

List Glossaries ConceptsTool to list concepts in a Crowdin glossary with pagination and sorting support.

List Glossary TermsTool to list all terms in a Crowdin glossary.

List Project File Strings (GraphQL)Tool to list source strings within files in Crowdin projects using GraphQL API.

List LabelsLists all labels in a Crowdin project with pagination support.

List LanguagesTool to retrieve a list of supported languages.

List MTsTool to retrieve a paginated list of Machine Translation engines.

List Project MembersTool to list members in a Crowdin project.

List Projects (v2)List all Crowdin projects accessible to the authenticated user with advanced filtering and sorting options.

List Projects ApprovalsTool to list translation approvals in a Crowdin project with filtering and pagination.

List BundlesRetrieves a paginated list of bundles in a Crowdin project.

List Bundle FilesTool to list files in a specific Crowdin project bundle.

List Project CommentsTool to retrieve a paginated list of comments on strings or assets in a Crowdin project.

List Project DictionariesTool to list all dictionaries in a Crowdin project.

List DirectoriesList all directories in a Crowdin project.

List DistributionsTool to retrieve a list of distributions for a Crowdin project.

List Project File Format SettingsTool to list all file format settings for a Crowdin project.

List Asset ReferencesTool to list asset references for a specific file in a Crowdin project.

List File RevisionsTool to list all revisions for a specific file in a Crowdin project.

List Projects IssuesTool to list reported issues in a Crowdin project.

List Language TranslationsTool to list language translations for a specific project and language.

List Projects QA ChecksTool to list QA check issues in a Crowdin project with pagination and filtering support.

List Report Settings TemplatesTool to list report settings templates for a Crowdin project.

List ScreenshotsTool to list screenshots in a Crowdin project.

List Project StringsLists all source strings in a Crowdin project with filtering and pagination.

List Project Strings Exporter SettingsTool to list project strings exporter settings in Crowdin.

List Task Settings TemplatesTool to retrieve a paginated list of task settings templates for a Crowdin project.

List Project BuildsTool to list translation builds for a Crowdin project.

List Translation VotesTool to list translation votes in a Crowdin project.

List Project WebhooksTool to retrieve a paginated list of webhooks configured in a Crowdin project.

List Project Task CommentsTool to retrieve all comments on a specific project task.

List StoragesTool to list files uploaded to Crowdin storage with pagination.

List TasksTool to list tasks in a Crowdin project.

List Translation MemoriesTool to list all Translation Memories available to the authenticated user.

List TM SegmentsTool to list Translation Memory segments in Crowdin.

List User AI PromptsTool to list AI prompts for a specific user in Crowdin.

List AI Prompt Fine-Tuning JobsTool to list AI prompt fine-tuning jobs for a specific user.

List User AI ProvidersTool to list all AI providers configured for a specific user.

List User AI Provider ModelsTool to list AI provider models configured for a specific user.

List Supported AI Provider ModelsTool to list supported AI provider models for a user.

List AI SnippetsTool to list AI snippets for a specific user in Crowdin.

List User Report ArchivesTool to list report archives for a Crowdin user.

List User Report Settings TemplatesTool to list user report settings templates in Crowdin.

List User Security LogsTool to list security log entries for a specific user.

List User TasksTool to retrieve a paginated list of tasks assigned to a specific user.

List User TasksTool to retrieve tasks assigned to the authenticated user across all projects.

List Viewer Projects FilesTool to list files within projects using GraphQL viewer query.

List Translations By LanguageTool to retrieve translation information for strings in specific target languages.

List Viewer Projects (GraphQL)Tool to retrieve projects via Crowdin GraphQL API using viewer.

List Viewer Projects TranslationsTool to list translations for projects in a specific language using GraphQL viewer query.

Notify Project MembersTool to send notifications to Crowdin project members.

Query GraphQL NodeTool to query Crowdin GraphQL Project nodes by their global ID.

Release DistributionTool to release a distribution in a Crowdin project.

Reset Project File Format Settings Custom SegmentationsTool to reset custom segmentations for file format settings in a Crowdin project.

Revalidate QA ChecksTool to revalidate QA checks for a Crowdin project.

Search Glossaries ConcordanceTool to search for glossary terms using concordance search in Crowdin.

Search TM ConcordanceTool to search for translations in Translation Memory (TM) using concordance search.

Send NotificationTool to send a notification message to the authenticated Crowdin user.

Update GlossariesTool to update glossary details using JSON-Patch operations.

Update Glossary ConceptTool to update a concept in a Crowdin glossary.

Update Glossary TermTool to update an existing glossary term in Crowdin using JSON Patch operations.

Update Custom LanguageTool to update a custom language in Crowdin using JSON-Patch operations.

Edit String/Asset CommentTool to edit a string or asset comment in a Crowdin project using JSON Patch operations.

Update BranchTool to update branch details using JSON-Patch operations.

Update BundleTool to update bundle properties in a Crowdin project using JSON-Patch operations.

Update Projects CommentsTool to perform batch operations on project comments using JSON-Patch.

Update Project DictionariesTool to edit a dictionary in a Crowdin project using JSON-Patch operations.

Update DirectoryTool to update directory details in a Crowdin project using JSON-Patch operations.

Edit DistributionTool to update distribution settings using JSON-Patch operations.

Update Project File Format SettingsTool to edit file format settings in a Crowdin project using JSON Patch operations.

Update or Restore FileTool to update or restore a file in a Crowdin project.

Update Report Settings TemplateTool to update a report settings template using JSON-Patch operations.

Edit ScreenshotTool to edit a screenshot in a Crowdin project using JSON Patch operations.

Edit Screenshot TagTool to edit a screenshot tag in a Crowdin project using JSON Patch operations.

Update Projects StringsTool to perform batch operations on strings in a Crowdin project using JSON Patch.

Update Project Strings Exporter SettingsTool to edit project strings exporter settings in Crowdin using JSON Patch operations.

Update Task Settings TemplateTool to update a task settings template in a Crowdin project using JSON Patch operations.

Update Project WebhookTool to update webhook configuration in a Crowdin project using JSON Patch operations.

Update Project TaskTool to update a project task in Crowdin using JSON Patch operations.

Edit Project Task CommentTool to edit a task comment in a Crowdin project using JSON Patch operations.

Update Translation MemoryTool to update a Translation Memory (TM) in Crowdin using JSON Patch operations.

Update TM SegmentsTool to edit a translation memory segment in Crowdin using JSON Patch operations.

Update Authenticated UserTool to update the authenticated user's profile using JSON Patch operations.

Update AI PromptTool to update an AI prompt in Crowdin using JSON-Patch operations.

Update User AI ProviderTool to edit an AI Provider for a specific user using JSON Patch operations.

Edit User AI SettingsTool to update AI settings for a Crowdin user using JSON Patch operations.

Update AI SnippetTool to update an existing AI snippet in Crowdin using JSON Patch operations.

Update User Report Settings TemplateTool to update a user report settings template in Crowdin using JSON Patch operations.

Update Organization WebhookTool to update organization webhook configuration in Crowdin using JSON Patch operations.

Upload StorageUpload a file to Crowdin storage to get a storage ID for subsequent operations.

Validate QA ChecksTool to validate translation text by QA checks in a Crowdin project.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Prerequisites

Before starting, make sure you have:

Composio API Key and OpenAI API Key
Primary know-how of OpenAI Agents SDK
A live Crowdin project
Some knowledge of Python or Typescript

Getting API Keys for OpenAI and Composio

OpenAI API Key

Go to the OpenAI dashboard 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.
Go to Settings and copy your API key.

Install dependencies

pip install composio_openai_agents openai-agents python-dotenv

Install the Composio SDK and the OpenAI Agents SDK.

Set up environment variables

bash

OPENAI_API_KEY=sk-...your-api-key
COMPOSIO_API_KEY=your-api-key
USER_ID=composio_user@gmail.com

Create a .env file and add your OpenAI and Composio API keys.

Import dependencies

import asyncio
import os
from dotenv import load_dotenv

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner, HostedMCPTool, SQLiteSession

What's happening:

You're importing all necessary libraries.
The Composio and OpenAIAgentsProvider classes are imported to connect your OpenAI agent to Composio tools like Crowdin.

Set up the Composio instance

load_dotenv()

api_key = os.getenv("COMPOSIO_API_KEY")
user_id = os.getenv("USER_ID")

if not api_key:
    raise RuntimeError("COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key")

# Initialize Composio
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())

What's happening:

load_dotenv() loads your .env file so OPENAI_API_KEY and COMPOSIO_API_KEY are available as environment variables.
Creating a Composio instance using the API Key and OpenAIAgentsProvider class.

Create a Tool Router session

# Create a Crowdin Tool Router session
session = composio.create(
    user_id=user_id,
    toolkits=["crowdin"]
)

mcp_url = session.mcp.url

What is happening:

You give the Tool Router the user id and the toolkits you want available. Here, it is only crowdin.
The router checks the user's Crowdin connection and prepares the MCP endpoint.
The returned session.mcp.url is the MCP URL that your agent will use to access Crowdin.
This approach keeps things lightweight and lets the agent request Crowdin tools only when needed during the conversation.

Configure the agent

# Configure agent with MCP tool
agent = Agent(
    name="Assistant",
    model="gpt-5",
    instructions=(
        "You are a helpful assistant that can access Crowdin. "
        "Help users perform Crowdin operations through natural language."
    ),
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "tool_router",
                "server_url": mcp_url,
                "headers": {"x-api-key": api_key},
                "require_approval": "never",
            }
        )
    ],
)

What's happening:

We're creating an Agent instance with a name, model (gpt-5), and clear instructions about its purpose.
The agent's instructions tell it that it can access Crowdin and help with queries, inserts, updates, authentication, and fetching database information.
The tools array includes a HostedMCPTool that connects to the MCP server URL we created earlier.
The headers dict includes the Composio API key for secure authentication with the MCP server.
require_approval: 'never' means the agent can execute Crowdin operations without asking for permission each time, making interactions smoother.

Start chat loop and handle conversation

print("\nComposio Tool Router session created.")

chat_session = SQLiteSession("conversation_openai_toolrouter")

print("\nChat started. Type your requests below.")
print("Commands: 'exit', 'quit', or 'q' to end\n")

async def main():
    try:
        result = await Runner.run(
            agent,
            "What can you help me with?",
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")
    except Exception as e:
        print(f"Error: {e}\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "q"}:
            print("Goodbye!")
            break

        result = await Runner.run(
            agent,
            user_input,
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")

asyncio.run(main())

What's happening:

The program prints a session URL that you visit to authorize Crowdin.
After authorization, the chat begins.
Each message you type is processed by the agent using Runner.run().
The responses are printed to the console, and conversations are saved locally using SQLite.
Typing exit, quit, or q cleanly ends the chat.

Complete Code

Here's the complete code to get you started with Crowdin and OpenAI Agents SDK:

import asyncio
import os
from dotenv import load_dotenv

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner, HostedMCPTool, SQLiteSession

load_dotenv()

api_key = os.getenv("COMPOSIO_API_KEY")
user_id = os.getenv("USER_ID")

if not api_key:
    raise RuntimeError("COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key")

# Initialize Composio
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())

# Create Tool Router session
session = composio.create(
    user_id=user_id,
    toolkits=["crowdin"]
)
mcp_url = session.mcp.url

# Configure agent with MCP tool
agent = Agent(
    name="Assistant",
    model="gpt-5",
    instructions=(
        "You are a helpful assistant that can access Crowdin. "
        "Help users perform Crowdin operations through natural language."
    ),
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "tool_router",
                "server_url": mcp_url,
                "headers": {"x-api-key": api_key},
                "require_approval": "never",
            }
        )
    ],
)

print("\nComposio Tool Router session created.")

chat_session = SQLiteSession("conversation_openai_toolrouter")

print("\nChat started. Type your requests below.")
print("Commands: 'exit', 'quit', or 'q' to end\n")

async def main():
    try:
        result = await Runner.run(
            agent,
            "What can you help me with?",
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")
    except Exception as e:
        print(f"Error: {e}\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "q"}:
            print("Goodbye!")
            break

        result = await Runner.run(
            agent,
            user_input,
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")

asyncio.run(main())

Conclusion

This was a starter code for integrating Crowdin MCP with OpenAI Agents SDK to build a functional AI agent that can interact with Crowdin.

Key features:

Hosted MCP tool integration through Composio's Tool Router
SQLite session persistence for conversation history
Simple async chat loop for interactive testing

You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent.

How to build Crowdin MCP Agent with another framework

Claude Agent SDK

Use Crowdin MCP with Claude Agent SDK

Claude Code

Use Crowdin MCP with Claude Code

Claude Cowork

Use Crowdin MCP with Claude Cowork

Codex

Use Crowdin MCP with Codex

OpenClaw

Use Crowdin MCP with OpenClaw

Hermes

Use Crowdin MCP with Hermes

CLI

Use Crowdin MCP with CLI

Google ADK

Use Crowdin MCP with Google ADK

LangChain

Use Crowdin MCP with LangChain

Vercel AI SDK

Use Crowdin MCP with Vercel AI SDK

Mastra AI

Use Crowdin MCP with Mastra AI

LlamaIndex

Use Crowdin MCP with LlamaIndex

CrewAI

Use Crowdin MCP with CrewAI

Explore Other Toolkits

Apilio

Api KeyBasic

Apilio is a home automation platform that lets you connect and control smart devices from different brands. It helps you build flexible automations with complex conditions, schedules, and integrations.

Basin

Api Key

Basin is a no-code form backend for quickly setting up reliable contact forms. It lets you collect and manage form submissions without writing any server-side code.

Bouncer

Api Key

Bouncer is an email validation platform that verifies the authenticity of email addresses in real-time and batch. It helps boost deliverability and reduce bounce rates for your communications.

TOOLKIT MARKETPLACE

FAQ

What are the differences in Tool Router MCP and Crowdin MCP?

With a standalone Crowdin MCP server, the agents and LLMs can only access a fixed set of Crowdin tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Crowdin and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with OpenAI Agents SDK?

Yes, you can. OpenAI Agents SDK 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 Crowdin tools.

Can I manage the permissions and scopes for Crowdin while using Tool Router?

Yes, absolutely. You can configure which Crowdin 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 Crowdin data and credentials are handled as safely as possible.

Used by agents from

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for free Get a demo↗

Harsha GaddipatiCo-founder, Slashy

Karan skipped his own birthday party to fix our critical issue. It was 10 pm and he diverted his Waymo to help us instead. This really sets the bar, shows you the commitment you need to have when users rely on your software.

Abhi AryaCo-founder, Opennote

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it has immensely helped in keeping new users on the platform.

Nirman DaveCEO, Zams

We chose Composio over Pipedream because it delivered depth where it mattered. It supported niche tools and tricky edge cases that other platforms simply ignored. Giving us confidence to scale without compromising.

Ryan YuFounder, Extra Thursday

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down in the complexities of managing agent auth would have been a death sentence for Extra Thursday.

Tomisin JenrolaFounder & CEO, SwarmZero

Before partnering with Composio, adding tool integrations was a slow, resource-intensive process. Each integration could take weeks or months of engineering time, and maintaining them meant constantly keeping up with API changes.

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

How to integrate Crowdin MCP with OpenAI Agents SDK

Table of Contents

Connect Crowdin without Auth hassles

Introduction

Also integrate Crowdin with

TL;DR

What is OpenAI Agents SDK?

What is the Crowdin MCP server, and what's possible with it?

Supported Tools & Triggers

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

How the Composio SDK works

Step-by-step Guide

Prerequisites

Getting API Keys for OpenAI and Composio

Install dependencies

Set up environment variables

Import dependencies

Set up the Composio instance

Create a Tool Router session

Configure the agent

Start chat loop and handle conversation

Complete Code

Conclusion

How to build Crowdin MCP Agent with another framework

Claude Agent SDK

Claude Code

Claude Cowork

Codex

OpenClaw

Hermes

CLI

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Explore Other Toolkits

Apilio

Basin

Bouncer

FAQ

What are the differences in Tool Router MCP and Crowdin MCP?

Can I use Tool Router MCP with OpenAI Agents SDK?

Can I manage the permissions and scopes for Crowdin while using Tool Router?

How safe is my data with Composio Tool Router?

Used by agents from

Never worry about agent reliability