Docs/AI Agent Overview
Guides

AI Agent Integration

ReceiptConverter is built to be used by AI agents. Here's every way to connect — from one-line MCP setup to raw API calls to no-code automation.

Choose your integration

MCPMCP Server (Recommended)

The easiest integration. Zero HTTP code — your AI client calls convert_receipt as a native tool.

Best for: Claude Desktop, Cursor, Windsurf, any MCP-compatible client
APIDirect API

A single POST request. Works with any language or framework that can make HTTP requests.

Best for: Custom agents, backend services, any HTTP client
OAIOpenAI Agents SDK

Define convert_receipt as a function tool and let OpenAI's SDK handle the orchestration.

Best for: Agents built with OpenAI's Agents SDK or function calling
LCLangChain

Wrap the API as a LangChain Tool and plug it into any agent chain or pipeline.

Best for: LangChain agents, chains, ReAct loops
NoNo-Code Automation

Use Zapier, Make, or n8n to connect ReceiptConverter to any app without writing code.

Best for: Non-technical users, workflow automation, connecting to 1000+ apps
OASOpenAPI Auto-discovery

Point any OpenAPI-aware framework at the spec URL and it auto-generates a working integration.

Best for: AutoGPT, LlamaIndex, LangChain OpenAPI toolkit, Google ADK

AI discoverability

ReceiptConverter publishes several files that AI agents use for auto-discovery — so frameworks like AutoGPT, LlamaIndex, or ChatGPT Plugins can find and use the API without any manual configuration:

Quick example — direct API call

For any agent that can make HTTP requests, this is all you need:

import requests

def convert_receipt(url_or_path: str, api_key: str) -> dict:
    headers = {"Authorization": f"Bearer {api_key}"}

    if url_or_path.startswith("http"):
        resp = requests.post(
            "https://receiptconverter.com/api/v1/convert",
            headers={**headers, "Content-Type": "application/json"},
            json={"url": url_or_path},
        )
    else:
        with open(url_or_path, "rb") as f:
            resp = requests.post(
                "https://receiptconverter.com/api/v1/convert",
                headers=headers,
                files={"file": f},
            )

    resp.raise_for_status()
    return resp.json()["data"]
Recommended path: Start with the MCP server if you use Claude or Cursor. Use the direct API for everything else.