Cody MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Cody MCP or direct API to search company knowledge, summarize documents, answer business questions, and automate workflows through natural language.

Cody logoCody
Api Key

Cody is an AI assistant built for businesses, trained on your company's knowledge and data. It delivers instant answers and insights, tailored for your team.

21 Tools

Try Cody now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Cody
Try asking
TOOLS

Supported Tools

Every Cody action and event your agent gets out of the box.

Create Conversation

Tool to create a new conversation with a specified bot.

Create Document

Tool to create a new document with text or HTML content in Cody AI.

Create Document From File

Tool to create a document by uploading a file (up to 100 MB).

Create Document from Webpage

Tool to create a document from a publicly accessible webpage URL.

Create Folder

Tool to create a new folder in Cody AI for organizing content.

Delete Conversation

Tool to delete a conversation by its ID.

Delete Document

Tool to delete a document by id.

Get Conversation

Tool to fetch a conversation by its ID from Cody AI.

Get Document

Tool to retrieve a specific document by its identifier from Cody AI.

Get Folder

Tool to retrieve a specific folder by its identifier.

Get Message

Tool to fetch a specific message by its ID from Cody AI.

Get Upload Signed URL

Tool to get an AWS S3 signed upload URL for file uploads.

List Bots

Tool to get all bots with optional keyword filtering.

List Conversations

Tool to get all conversations with optional filtering by bot, keyword, or includes.

List Documents

Tool to retrieve all documents from Cody AI account with optional filtering.

List Folders

Tool to retrieve all folders with optional keyword filtering.

List Messages

Tool to retrieve a paginated list of messages from Cody, optionally filtered by conversation.

Send Message

Tool to send a message to Cody AI and receive an AI-generated response.

Send Message for Stream

Tool to send a message to Cody AI and receive a Server-Sent Events (SSE) stream URL for the AI response.

Update Conversation

Tool to update a conversation by its ID including name, bot_id, and document_ids.

Update Folder

Tool to update a folder by its ID.

SETUP GUIDE

Connect Cody MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Cody
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Summarize our latest product update docs.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Cody API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Cody Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Search company handbook for remote work policy.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Cody actions with your Agent

Why Use Composio?

AI Native Cody Integration

  • Supports both Cody MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Cody data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Cody access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Cody
  • Scoped, least privilege access to Cody resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Cody requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Cody.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Cody tool your agent needs.Free to start.

Start building