Unstructured MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Unstructured MCP or direct API to parse documents, extract schema-defined fields, manage uploads, and track processing jobs through natural language.

Unstructured logoUnstructured
Api Key

Unstructured is a document-processing service that turns files into Markdown and structured elements. It helps teams extract clean, usable data from complex documents.

9 Tools

Try Unstructured now

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

TOOL ROUTER PLAYGROUND
Unstructured
Try asking
TOOLS

Supported Tools

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

Cancel Job

Request irreversible cancellation of one queued or processing Parse or Extract job and return its immediate status snapshot; terminal jobs are unchanged.

Delete Job

Request asynchronous removal of one terminal Parse or Extract job from job listings; source and output blobs may remain temporarily.

Delete Uploaded File

Permanently delete one temporary uploaded file; related jobs remain and a queued job may fail if it has not consumed the file.

Download Uploaded File

Download the exact bytes of a previously uploaded scratch file before it expires.

Extract Fields

Extract schema-defined fields from one uploaded document, stored file, or completed Parse job, either waiting for a result or returning a queued job.

Get Job

Get the current status, error, configuration, and available result for one Parse or Extract job.

List Jobs

Return one newest-first page of Parse and Extract jobs, optionally filtered by status or operation, with a cursor for the next page.

Parse Document

Parse one uploaded or previously stored document into Markdown or structured elements; optionally extract schema-defined fields and either wait for a result or return a queued job.

Upload File

Upload one supported document to 24-hour scratch storage for reuse by Parse Document or Extract Fields.

SETUP GUIDE

Connect Unstructured MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["unstructured"],
  mcp: true,
});
Create a session scoped to Unstructured and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Parse the uploaded invoice PDF into clean Markdown and extract its invoice number, vendor, total, and due date.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Unstructured request
SETUP GUIDE

Connect Unstructured API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["unstructured"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Unstructured
3

Run Unstructured tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Parse the uploaded invoice PDF into clean Markdown and extract its invoice number, vendor, total, and due date." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Unstructured tool calls through the session, and print the final answer

Why Use Composio?

AI Native Unstructured Integration

  • Supports both Unstructured MCP and direct API integrations
  • Structured, LLM-friendly schemas for reliable document parsing and field extraction
  • Rich coverage for processing files, managing uploads, and checking asynchronous jobs

Managed Auth

  • Securely stores and applies your Unstructured API key
  • Central place to manage, scope, and revoke Unstructured 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 Unstructured
  • Scoped, least privilege access to Unstructured resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Unstructured.It takes 30 seconds.

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

Start building