Cradl AI
Cradl AI is an API-first platform for building and operating AI-powered document extraction workflows.
Verdict
Common use cases
- Extract invoice line items for AP review
- Validate receipt fields against expense policy
- Triage incoming contract PDFs by clause type
- Monitor extraction job status across agents
- Download parsed data for ERP import
Integration
- Vendor
- Cradl AI
- Category
- docs
- Auth
- OAUTH2
- Tools
- 11
- Composio slug
cradl_ai
Tools
- 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. Poll this read-only tool until the run reaches a terminal status; it does not itself consume page quota.
- Get Document
Get metadata, processing links, and annotations for one Cradl AI document by ID. This read does not consume page quota.
- Get Prediction
Get one extracted prediction, including its status, fields, errors, and downloadable output references. This read does not consume page quota.
- List Agent Runs
List processing runs for an agent, optionally filtered by status or creation/update time. Use this to discover recent extraction jobs and their run IDs.
- List Agents
List document-processing agents available to the connected Cradl AI workspace. Use an agent ID from this result to start an extraction run.
- 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. This consumes processed-page quota. It returns immediately after upload and does not poll extraction; use the composite
- Start Agent Run
Create a processing run for an existing Cradl AI agent. This creates persistent run state; attaching and processing document content against the run consumes the workspace's monthly processed-page quota.
- Upload Document to Run
Create a document attached to a Cradl AI agent run and upload its PDF, image, or email bytes. The upload starts asynchronous processing and consumes the workspace's monthly processed-page quota.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration', search for Cradl AI, and select it. 3. Click 'Connect' to launch the OAuth flow in a new browser tab. 4. Sign in to your Cradl AI account and authorize Switchy to read documents, list agents, create runs, and download outputs. 5. Once redirected back to Switchy, confirm the connection appears as 'Active' in your integrations list. 6. Open any Project, type '@Cradl' in the chat, and ask it to list your agents to verify the connection works. 7. To test extraction, upload a sample document to Cradl AI via their web app, then in Switchy prompt '@Cradl list my recent documents' and '@Cradl get prediction for document [ID]' to retrieve parsed fields. 8. Remember that starting an agent run consumes pages from your Cradl quota; check your plan limits before automating large batches.
What teammates see: by default, memories from Cradl AI are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Extraction Agents
@Cradl list all agents in my workspace and show me their names and IDs.
Check Recent Documents
@Cradl list my most recent documents, including their IDs and any output file URLs.
Get Extraction Results
@Cradl get prediction [prediction-id] and show me all extracted fields and their confidence scores.
Monitor Agent Run
@Cradl get agent run [run-id] and tell me its current status and any outputs available.
Download Parsed Output
@Cradl download the output file from prediction [prediction-id] and save it to this Project.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@cradl download the OCR text from document doc_p7q2r and summarize the key contract terms in plain language
Downloaded OCR content from doc_p7q2r (12-page service agreement, 8,421 words). Key terms: Contract duration is 24 months starting March 1, 2024, with automatic renewal unless either party provides 90 days' notice. Monthly fee is $12,500 with annual 3% escalation. Termination for convenience requires 60 days' notice and a $25,000 early exit fee if terminated before month 18. Liability is capped at 12 months of fees paid. Dispute resolution requires binding arbitration in Delaware.
This synthesis example pairs Cradl's OCR output with the AI's reasoning to extract business insights from raw text. The Download File tool retrieves content that other Cradl tools reference by URL. Large documents may hit token limits; consider asking for specific sections rather than full summaries.
Use-case deep-dives
When Cradl AI beats manual invoice entry at 20+ invoices/week
A 3-person finance team at a B2B SaaS company receives 30-40 vendor invoices weekly via email and Slack. They spend 6 hours a week manually keying line items into NetSuite. Cradl AI is the right call here: set up an agent that watches a shared inbox, extracts invoice fields (vendor, date, line items, totals), and writes structured predictions the team reviews in a Switchy thread before pushing to the ERP. The OAuth2 flow means the CFO controls workspace access without sharing API keys. The threshold: if your invoices are highly standardized (same 5 vendors, identical layouts), a simpler regex scraper is cheaper. But if formats vary or you're adding new vendors monthly, Cradl's agent-based extraction adapts without re-coding. Poll Get Agent Run until status is terminal, then pull the prediction and route it to your approval workflow.
Cradl AI for high-volume NDA and MSA clause extraction
A 2-person legal ops team at a 50-employee startup reviews 15-20 inbound NDAs and MSAs each month, hunting for non-standard liability caps, auto-renewal clauses, and jurisdiction terms. They currently CMD+F through PDFs and log findings in a spreadsheet. Cradl AI works well here: upload each contract as a document, run a trained agent that extracts the 8-10 clauses you care about, then review the prediction output in Switchy alongside the original PDF link. The List Documents and List Predictions tools let you batch-check what's been processed and spot any failed runs. The trade-off: if your contract volume is under 5/month or the clauses are so bespoke that extraction confidence stays below 80 percent, manual review is faster. Above 10/month with repeating clause patterns, Cradl saves 4-6 hours weekly and catches terms human skimming misses.
When Cradl AI routes support docs faster than human sorting
A 6-person support team at a fintech handles 200 tickets daily, 40 percent of which include uploaded bank statements, tax forms, or ID scans. Agents currently open each attachment, eyeball the doc type, and tag the ticket for the right specialist queue. Cradl AI fits if you're drowning in attachment volume: configure an agent to classify doc types (W-2, 1099, bank statement, utility bill) and extract key fields (account number, date, issuer). Use Get Document to pull metadata and Download File to grab the OCR'd text, then auto-tag the ticket in your helpdesk. The 11-tool set gives you enough flexibility to handle multi-page PDFs and low-quality phone photos. The boundary: if attachments are under 30/day or your team already has a dedicated doc-processing VA, the OAuth2 setup overhead isn't worth it. Above 50/day, Cradl cuts triage time by half and routes 85 percent of tickets correctly on first pass.
Frequently asked
What does the Cradl AI MCP do in Switchy?
It lets your team extract structured data from documents using Cradl AI's trained models. You can list available agents, kick off extraction runs, poll for results, and download the parsed output—all from Switchy's chat interface. Think invoices, receipts, forms, or custom document types your team has trained Cradl to recognise.
Do I need admin access to connect Cradl AI via OAuth?
You need a Cradl AI account with permission to view agents and documents in your workspace. OAuth will ask for read and write access to your workspace's agents, documents, and predictions. If your Cradl workspace has role-based access controls, check that your account can list agents and create runs before connecting.
Can the MCP train new Cradl models or edit existing agents?
No. The MCP reads agent configurations and triggers extraction runs, but it doesn't train models or modify agent settings. Model training and agent setup still happen in Cradl's web UI. Once your agents are configured there, Switchy can run them and retrieve results.
Why use the MCP instead of Cradl's API directly?
The MCP wraps Cradl's REST endpoints so your team can extract data conversationally—no code required. You ask "extract fields from this invoice", and Switchy handles the agent lookup, run creation, and polling. If you're already building a custom integration, stick with the API; if you want ad-hoc extraction in chat, use the MCP.
Does running extractions through Switchy count against my Cradl page quota?
Yes. Every document you process via the MCP consumes pages from your Cradl AI plan, exactly as if you'd uploaded it through Cradl's web interface. The MCP's read-only calls—listing agents, fetching run status—don't consume quota, but starting a new agent run does.