Cradl AI MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Cradl AI MCP or direct API to upload documents, run extraction workflows, review results, and monitor processing status through natural language.

Cradl AI logoCradl AI
S2s Oauth2

Cradl AI is an API-first platform for AI-powered document extraction workflows. Use it to turn invoices, forms, and PDFs into structured data at scale.

11 Tools

Try Cradl AI now

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

TOOL ROUTER PLAYGROUND
Cradl AI
Try asking
TOOLS

Supported Tools

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

Download File

Download document, OCR, annotation, prediction, or run-variable content from a Cradl AI file URL returned by another Cradl AI tool.

Get Agent Run

Get the current state and outputs of one Cradl AI agent run.

Get Document

Get metadata, processing links, and annotations for one Cradl AI document by ID.

Get Prediction

Get one extracted prediction, including its status, fields, errors, and downloadable output references.

List Agent Runs

List processing runs for an agent, optionally filtered by status or creation/update time.

List Agents

List document-processing agents available to the connected Cradl AI workspace.

List Documents

List documents in the connected Cradl AI workspace and discover document IDs and content/output file URLs.

List Predictions

List extracted predictions, optionally filtered by model, and discover prediction IDs and output file URLs.

Process Document

Create a persistent Cradl agent run and document, then upload one document for asynchronous extraction in a single call.

Start Agent Run

Create a processing run for an existing Cradl AI agent.

Upload Document to Run

Create a document attached to a Cradl AI agent run and upload its PDF, image, or email bytes.

SETUP GUIDE

Connect Cradl AI 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 Cradl AI
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: 'List failed Cradl AI document extraction jobs'
  }],
  maxSteps: 5,
});

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

Connect Cradl AI 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 Cradl AI 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: 'List failed Cradl AI document extraction jobs'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Cradl AI actions with your Agent

Why Use Composio?

AI Native Cradl AI Integration

  • Supports both Cradl AI MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable document extraction tasks
  • Rich coverage for working with extraction workflows, documents, and results

Managed Auth

  • Built-in S2S OAuth2 handling with secure token storage and lifecycle management
  • Central place to manage, scope, and revoke Cradl AI access
  • Per user and per environment credentials instead of hard-coded secrets

Agent Optimized Design

  • Tools are tuned so agents can run Cradl AI extraction workflows with fewer mistakes
  • Clear tool inputs help models understand documents, jobs, and extraction results
  • 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 Cradl AI
  • Scoped, least privilege access to Cradl AI document extraction resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Cradl AI with any AI Agent Framework

Choose a Framework you want to connect Cradl AI with

FAQ

Frequently asked questions

Yes, Cradl AI requires you to configure your own S2S OAuth2 credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you. Create your Cradl AI auth config with auth_configs.create(), link a user account with connected_accounts.link(), then expose tools through mcp.create() or a Tool Router session.

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 Cradl AI.It takes 30 seconds.

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

Start building