MCP

The Iteration Layer API includes a built-in Model Context Protocol (MCP) server. MCP lets AI agents like Claude Desktop, Cursor, and Windsurf call the API directly as tools — no custom integration code required.

Server Endpoint

The MCP server is available via Streamable HTTP transport:

https://api.iterationlayer.com/mcp

Authentication

The MCP endpoint uses OAuth 2.1 — not API keys. Your MCP client handles the authentication flow automatically. When you first use an Iteration Layer tool, a browser window will open for you to log in and authorize access.

Available Tools

The MCP server exposes four tools that map to the Iteration Layer APIs:

extract_document

Extract structured data from documents using AI. Supports PDF, DOCX, images (PNG, JPG, GIF, WebP), and text files (MD, TXT, CSV, JSON).

Parameters:

• files (required) — Array of file inputs (each with type, name, and either base64 or url)
• schema (required) — Extraction schema with a fields array defining what to extract

See Document Extraction for the full schema reference.

transform_image

Transform and manipulate images. Supports 23 operations: resize, crop, extend, trim, rotate, flip, flop, blur, sharpen, modulate, tint, grayscale, invertColors, autoContrast, gamma, removeTransparency, threshold, denoise, opacity, convert, upscale, smartCrop, compressToSize.

Parameters:

• file (required) — File input with type, name, and either base64 or url
• operations (required) — Array of transformation operations to apply in order

See Image Transformation for the full operations reference.

generate_image

Generate images from layer compositions. Layer types: solid-color-background, rectangle, text, static-image, image-overlay, qr-code, barcode, gradient. Layers are composited by index order.

See Image Generation for the full composition schema.

generate_document

Generate PDF, DOCX, PPTX, or EPUB documents from structured definitions. Documents are composed of metadata, page settings, styles, and content blocks (paragraph, headline, image, table, grid, list, table-of-contents, page-break, separator).

Client Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "iterationlayer": {
      "type": "streamablehttp",
      "url": "https://api.iterationlayer.com/mcp"
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "iterationlayer": {
      "type": "streamablehttp",
      "url": "https://api.iterationlayer.com/mcp"
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "iterationlayer": {
      "type": "streamablehttp",
      "url": "https://api.iterationlayer.com/mcp"
    }
  }
}

Billing

MCP tool calls consume credits the same way as direct API calls. See Credits & Pricing for details.