Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat: add mcp support for open ai (#1667)

Apoorv Taneja63f76f4faa70
diff --git a/ts/examples/openai/package.json b/ts/examples/openai/package.json
index 1b1d6fb78..5870413ec 100644
--- a/ts/examples/openai/package.json
+++ b/ts/examples/openai/package.json
@@ -10,6 +10,7 @@
"start:assistant": "bun src/assistants.ts",
"start:agents": "bun src/agents-api/index.ts",
"examples": "bun src/examples.ts",
+ "start:mcp": "bun src/mcp.ts",
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
diff --git a/ts/examples/openai/src/mcp.ts b/ts/examples/openai/src/mcp.ts
new file mode 100644
index 000000000..806451938
--- /dev/null
+++ b/ts/examples/openai/src/mcp.ts
@@ -0,0 +1,90 @@
+/**
+ * OpenAI MCP Gmail Example
+ *
+ * This example demonstrates how to use Composio MCP with OpenAI to:
+ * 1. Create an MCP server for Gmail toolkit
+ * 2. Generate URLs for the server
+ * 3. Use OpenAI to summarize emails
+ *
+ */
+
+import { OpenAIResponsesProvider } from '@composio/openai';
+import { Composio } from '@composio/core';
+import OpenAI from 'openai';
+import dotenv from 'dotenv';
+dotenv.config();
+
+/**
+ * Initialize Composio with OpenAI provider
+ */
+const composio = new Composio({
+ apiKey: process.env.COMPOSIO_API_KEY,
+ provider: new OpenAIResponsesProvider(),
+});
+
+/**
+ * Initialize OpenAI client
+ */
+const openai = new OpenAI({
+ apiKey: process.env.OPENAI_API_KEY,
+});
+
+// Create an MCP server with Gmail toolkit
+const mcpConfig = await composio.mcp.create(
+ "gmail-mcp-openai-" + Date.now(),
+ [
+ {
+ toolkit: "gmail",
+ authConfigId: "<auth_config_id>", // Replace with your auth config ID
+ allowedTools: [
+ "GMAIL_FETCH_EMAILS"
+ ]
+ }
+ ],
+ { useComposioManagedAuth: true }
+);
+
+console.log(`✅ MCP server created: ${mcpConfig.id}`);
+console.log(`🔧 Available toolkits: ${mcpConfig.toolkits.join(', ')}`);
+
+// Get server URLs with connected accounts (using convenience method)
+const serverUrls = await mcpConfig.getServer({
+ connectedAccountIds: {
+ "gmail": "<connected_account_id>" // Replace with your connected account ID
+ }
+});
+
+// Alternative: You can also use the standalone method to get URLs later
+// const serverUrls = await composio.mcp.getServer(mcpConfig.id, {
+// connectedAccountIds: {
+// "gmail": "<connected_account_id>"
+// }
+// });
+
+console.log("Server URLs for connected accounts:", serverUrls);
+
+// Function to fetch and summarize emails
+async function fetchAndSummarizeEmails() {
+ try {
+ // Use OpenAI to summarize the emails
+ console.log('\n=== Generating Email Summary ===');
+ const completion = await openai.responses.create({
+ model: "gpt-4o-mini",
+ input: "I've connected to gmail and I want to fetch the latest email from my inbox and summarize it",
+ tools: serverUrls,
+ });
+
+ console.log('\n📬 Email Summary:');
+ console.log(completion.output_text);
+
+ } catch (error) {
+ console.error('Error fetching or summarizing emails:', error);
+ }
+}
+
+// Run the email summarization
+await fetchAndSummarizeEmails();
+
+console.log('\n✅ OpenAI MCP Example completed successfully!');
+console.log('\n💡 Note: The MCP server URLs can be used to connect from other MCP-compatible clients');
+console.log(`📍 Server ID for future reference: ${mcpConfig.id}`);
diff --git a/ts/packages/core/src/models/MCP.ts b/ts/packages/core/src/models/MCP.ts
index fedb6fe3f..d35d7c259 100644
--- a/ts/packages/core/src/models/MCP.ts
+++ b/ts/packages/core/src/models/MCP.ts
@@ -17,7 +17,6 @@ import {
CustomCreateResponseSchema,
GenerateURLResponseSchema,
GenerateURLParamsSnakeCaseSchema,
- GenerateURLParamsValidated,
McpListResponseSchema,
McpRetrieveResponseSchema,
McpDeleteResponseSchema,
@@ -497,9 +496,7 @@ export class MCP<T = McpServerGetResponse> {
*
* @param data - The MCP URL response data (in camelCase)
* @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
+
* @returns Transformed response in appropriate format
*/
private wrapMcpServerResponse(
@@ -511,20 +508,29 @@ export class MCP<T = McpServerGetResponse> {
): T {
// Check if provider has a custom transform method
if (this.provider && typeof this.provider.wrapMcpServerResponse === 'function') {
- // Convert to snake_case for backward compatibility with providers
- const snakeCaseData: McpUrlResponse = {
- mcp_url: data.mcpUrl,
- ...(data.connectedAccountUrls && { connected_account_urls: data.connectedAccountUrls }),
- ...(data.userIdsUrl && { user_ids_url: data.userIdsUrl }),
- };
-
- const transformed = this.provider.wrapMcpServerResponse(
- snakeCaseData,
- serverName,
- connectedAccountIds,
- userIds,
- toolkits
- );
+ // Convert to array of name and url based on connected accounts or user ids
+ let snakeCaseData: McpUrlResponse;
+
+ if (data.connectedAccountUrls?.length) {
+ snakeCaseData = data.connectedAccountUrls.map((url, index) => ({
+ name: serverName + '-' + connectedAccountIds?.[index],
+ url: url,
+ }));
+ } else if (data.userIdsUrl?.length) {
+ snakeCaseData = data.userIdsUrl.map((url, index) => ({
+ name: serverName + '-' + userIds?.[index],
+ url: url,
+ }));
+ } else {
+ snakeCaseData = [
+ {
+ name: serverName,
+ url: data.mcpUrl,
+ },
+ ];
+ }
+
+ const transformed = this.provider.wrapMcpServerResponse(snakeCaseData);
return transformed as T;
}
diff --git a/ts/packages/core/src/provider/BaseProvider.ts b/ts/packages/core/src/provider/BaseProvider.ts
index b10b899e4..21468b2f0 100644
--- a/ts/packages/core/src/provider/BaseProvider.ts
+++ b/ts/packages/core/src/provider/BaseProvider.ts
@@ -66,18 +66,10 @@ abstract class BaseProvider<TMcpResponse = McpServerGetResponse> {
*
* @param data - The MCP URL response data
* @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
+
* @returns Transformed response in provider-specific format, or undefined to use default transformation
*/
- wrapMcpServerResponse?(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): TMcpResponse;
+ wrapMcpServerResponse?(data: McpUrlResponse): TMcpResponse;
}
/**
diff --git a/ts/packages/core/src/provider/OpenAIProvider.ts b/ts/packages/core/src/provider/OpenAIProvider.ts
index bc7788418..edcedf657 100644
--- a/ts/packages/core/src/provider/OpenAIProvider.ts
+++ b/ts/packages/core/src/provider/OpenAIProvider.ts
@@ -51,37 +51,13 @@ export class OpenAIProvider extends BaseNonAgenticProvider<OpenAiToolCollection,
* OpenAI uses the standard format by default.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // OpenAI uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ }));
}
/**
diff --git a/ts/packages/core/src/types/mcp.types.ts b/ts/packages/core/src/types/mcp.types.ts
index 4b986eba5..5a4044f06 100644
--- a/ts/packages/core/src/types/mcp.types.ts
+++ b/ts/packages/core/src/types/mcp.types.ts
@@ -193,10 +193,9 @@ export type McpUrlResponseCamelCase = {
// Snake_case URL response (for internal API use)
export type McpUrlResponse = {
- connected_account_urls?: string[];
- user_ids_url?: string[];
- mcp_url: string;
-};
+ name: string;
+ url: string;
+}[];
export type McpServerCreateResponse<T> = (McpCreateResponse | CustomCreateResponse) & {
toolkits: string[];
diff --git a/ts/packages/core/test/models/mcp.test.ts b/ts/packages/core/test/models/mcp.test.ts
index 0f10dff23..2c871939e 100644
--- a/ts/packages/core/test/models/mcp.test.ts
+++ b/ts/packages/core/test/models/mcp.test.ts
@@ -168,17 +168,12 @@ class MockProvider extends BaseAgenticProvider<MockToolCollection, MockTool, Moc
return tools.map(tool => this.wrapTool(tool, executeTool));
}
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): MockMcpResponse {
+ wrapMcpServerResponse(data: McpUrlResponse): MockMcpResponse {
+ // McpUrlResponse is an array of { name, url } objects
return {
customFormat: true,
- serverName,
- urls: data.connected_account_urls || [data.mcp_url],
+ serverName: data[0]?.name || 'test-mcp-server',
+ urls: data.map(item => item.url),
};
}
}
@@ -384,7 +379,12 @@ describe('MCP', () => {
managedAuthViaComposio: mockRetrieveResponse.managed_auth_via_composio,
});
- mockClient.mcp.generate.url.mockResolvedValue(mockGenerateUrlResponse);
+ // Mock a response with only one URL for the single userId
+ const singleUserResponse = {
+ user_ids_url: ['https://mcp.example.com/user_123'],
+ mcp_url: 'https://mcp.example.com/server',
+ };
+ mockClient.mcp.generate.url.mockResolvedValue(singleUserResponse);
const result = await mcpWithProvider.getServer('mcp_123', {
userId: 'user_123',
@@ -392,7 +392,8 @@ describe('MCP', () => {
expect(result).toMatchObject({
customFormat: true,
- serverName: 'test-mcp-server',
+ serverName: 'test-mcp-server-user_123',
+ urls: ['https://mcp.example.com/user_123'],
});
});
});
diff --git a/ts/packages/providers/anthropic/src/index.ts b/ts/packages/providers/anthropic/src/index.ts
index 6ca269fcb..82bbddc55 100644
--- a/ts/packages/providers/anthropic/src/index.ts
+++ b/ts/packages/providers/anthropic/src/index.ts
@@ -298,36 +298,13 @@ export class AnthropicProvider extends BaseNonAgenticProvider<
* but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
// Anthropic uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ })) as McpServerGetResponse;
}
}
diff --git a/ts/packages/providers/cloudflare/src/index.ts b/ts/packages/providers/cloudflare/src/index.ts
index f73592c4b..dc17cb297 100644
--- a/ts/packages/providers/cloudflare/src/index.ts
+++ b/ts/packages/providers/cloudflare/src/index.ts
@@ -52,41 +52,19 @@ export class CloudflareProvider extends BaseNonAgenticProvider<
}
/**
- * Transform MCP URL response into Cloudflare-specific format.
- * Cloudflare uses the standard format by default.
+ * Transform MCP URL response into Anthropic-specific format.
+ * By default, Anthropic uses the standard format (same as default),
+ * but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // Cloudflare uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
+ // Anthropic uses the standard format
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ })) as McpServerGetResponse;
}
/**
diff --git a/ts/packages/providers/google/src/index.ts b/ts/packages/providers/google/src/index.ts
index 3888a3015..277808af7 100644
--- a/ts/packages/providers/google/src/index.ts
+++ b/ts/packages/providers/google/src/index.ts
@@ -71,41 +71,19 @@ export class GoogleProvider extends BaseNonAgenticProvider<GoogleGenAIToolCollec
}
/**
- * Transform MCP URL response into Google-specific format.
- * Google uses the standard format by default.
+ * Transform MCP URL response into Anthropic-specific format.
+ * By default, Anthropic uses the standard format (same as default),
+ * but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // Google uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
+ // Anthropic uses the standard format
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ })) as McpServerGetResponse;
}
/**
diff --git a/ts/packages/providers/langchain/src/index.ts b/ts/packages/providers/langchain/src/index.ts
index d6f90131f..78371551c 100644
--- a/ts/packages/providers/langchain/src/index.ts
+++ b/ts/packages/providers/langchain/src/index.ts
@@ -52,41 +52,19 @@ export class LangchainProvider extends BaseAgenticProvider<
}
/**
- * Transform MCP URL response into LangChain-specific format.
- * LangChain uses the standard format by default.
+ * Transform MCP URL response into Anthropic-specific format.
+ * By default, Anthropic uses the standard format (same as default),
+ * but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // LangChain uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
+ // Anthropic uses the standard format
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ })) as McpServerGetResponse;
}
/**
diff --git a/ts/packages/providers/mastra/src/index.ts b/ts/packages/providers/mastra/src/index.ts
index 58e6fa7fb..48bf6db0b 100644
--- a/ts/packages/providers/mastra/src/index.ts
+++ b/ts/packages/providers/mastra/src/index.ts
@@ -37,44 +37,19 @@ export class MastraProvider extends BaseAgenticProvider<
}
/**
- * Transform MCP URL response into Mastra-specific format.
- * Mastra expects URLs in a key-value map format.
+ * Transform MCP URL response into Anthropic-specific format.
+ * By default, Anthropic uses the standard format (same as default),
+ * but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @returns Transformed MastraUrlMap
+ * @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[]
- ): MastraUrlMap {
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.reduce(
- (prev: MastraUrlMap, url: string, index: number) => {
- prev[`${serverName}-${index}`] = {
- url: url,
- };
- return prev;
- },
- {}
- );
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.reduce((prev: MastraUrlMap, url: string, index: number) => {
- prev[`${serverName}-${index}`] = {
- url: url,
- };
- return prev;
- }, {});
- }
- return {
- [serverName]: {
- url: data.mcp_url,
- },
- };
+ wrapMcpServerResponse(data: McpUrlResponse): MastraUrlMap {
+ // Transform to Mastra's URL map format
+ return data.reduce((acc: MastraUrlMap, item) => {
+ acc[item.name] = { url: item.url };
+ return acc;
+ }, {});
}
wrapTool(tool: Tool, executeTool: ExecuteToolFn): MastraTool {
diff --git a/ts/packages/providers/openai-agents/src/index.ts b/ts/packages/providers/openai-agents/src/index.ts
index d2aff2ba5..c44956389 100644
--- a/ts/packages/providers/openai-agents/src/index.ts
+++ b/ts/packages/providers/openai-agents/src/index.ts
@@ -56,41 +56,19 @@ export class OpenAIAgentsProvider extends BaseAgenticProvider<
}
/**
- * Transform MCP URL response into OpenAI Agents-specific format.
- * OpenAI Agents uses the standard format by default.
+ * Transform MCP URL response into Anthropic-specific format.
+ * By default, Anthropic uses the standard format (same as default),
+ * but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // OpenAI Agents uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
+ // Anthropic uses the standard format
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ })) as McpServerGetResponse;
}
/**
diff --git a/ts/packages/providers/openai/src/OpenAIResponsesProvider.ts b/ts/packages/providers/openai/src/OpenAIResponsesProvider.ts
index 4f28c29f6..34bda8e1d 100644
--- a/ts/packages/providers/openai/src/OpenAIResponsesProvider.ts
+++ b/ts/packages/providers/openai/src/OpenAIResponsesProvider.ts
@@ -17,12 +17,11 @@ import {
ExecuteToolModifiers,
ExecuteToolFnOptions,
removeNonRequiredProperties,
- logger,
McpUrlResponse,
- McpServerGetResponse,
} from '@composio/core';
export type OpenAiTool = OpenAI.Responses.FunctionTool;
+export type OpenAiMcpTool = OpenAI.Responses.Tool.Mcp;
export type OpenAiToolCollection = Array<OpenAiTool>;
export type OpenAIResponsesProviderOptions = {
/**
@@ -31,9 +30,19 @@ export type OpenAIResponsesProviderOptions = {
*/
strict?: boolean;
};
+
+/**
+ * OpenAI-specific MCP server response format
+ */
+export interface OpenAIMcpServerResponse {
+ type: 'mcp';
+ server_label: string;
+ server_url: string;
+}
export class OpenAIResponsesProvider extends BaseNonAgenticProvider<
OpenAiToolCollection,
- OpenAiTool
+ OpenAiTool,
+ OpenAIMcpServerResponse[]
> {
readonly name = 'openai';
private strict: boolean | null;
@@ -70,40 +79,19 @@ export class OpenAIResponsesProvider extends BaseNonAgenticProvider<
/**
* Transform MCP URL response into OpenAI Responses-specific format.
- * OpenAI Responses uses the standard format by default.
+ * OpenAI Responses uses a custom format with type, server_label, server_url, and require_approval fields.
*
* @param data - The MCP URL response data
* @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
- * @returns Standard MCP server response format
+ * @returns OpenAI-specific MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // OpenAI Responses uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): OpenAiMcpTool[] {
+ return data.map(item => ({
+ type: 'mcp',
+ server_label: item.name,
+ server_url: item.url,
+ require_approval: 'never',
+ }));
}
/**
diff --git a/ts/packages/providers/vercel/src/index.ts b/ts/packages/providers/vercel/src/index.ts
index 7f468c33c..9275744b0 100644
--- a/ts/packages/providers/vercel/src/index.ts
+++ b/ts/packages/providers/vercel/src/index.ts
@@ -14,7 +14,6 @@ import {
BaseAgenticProvider,
Tool,
ExecuteToolFn,
- jsonSchemaToZodSchema,
McpUrlResponse,
McpServerGetResponse,
} from '@composio/core';
@@ -182,40 +181,18 @@ export class VercelProvider extends BaseAgenticProvider<VercelToolCollection, Ve
}
/**
- * Transform MCP URL response into Vercel-specific format.
- * Vercel uses the standard format by default.
+ * Transform MCP URL response into Anthropic-specific format.
+ * By default, Anthropic uses the standard format (same as default),
+ * but this method is here to show providers can customize if needed.
*
* @param data - The MCP URL response data
- * @param serverName - Name of the MCP server
- * @param connectedAccountIds - Optional array of connected account IDs
- * @param userIds - Optional array of user IDs
- * @param toolkits - Optional array of toolkit names
* @returns Standard MCP server response format
*/
- wrapMcpServerResponse(
- data: McpUrlResponse,
- serverName: string,
- connectedAccountIds?: string[],
- userIds?: string[],
- toolkits?: string[]
- ): McpServerGetResponse {
- // Vercel uses the standard format
- if (connectedAccountIds?.length && data.connected_account_urls) {
- return data.connected_account_urls.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${connectedAccountIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- } else if (userIds?.length && data.user_ids_url) {
- return data.user_ids_url.map((url: string, index: number) => ({
- url: new URL(url),
- name: `${serverName}-${userIds[index]}`,
- toolkit: toolkits?.[index],
- })) as McpServerGetResponse;
- }
- return {
- url: new URL(data.mcp_url),
- name: serverName,
- } as McpServerGetResponse;
+ wrapMcpServerResponse(data: McpUrlResponse): McpServerGetResponse {
+ // Anthropic uses the standard format
+ return data.map(item => ({
+ url: new URL(item.url),
+ name: item.name,
+ })) as McpServerGetResponse;
}
}