Integration

Catalogian + OpenAI Agents SDK

The OpenAI Agents SDK lets you build AI agents using OpenAI's tool-use and Responses API format. Catalogian provides a native Responses API-compatible endpoint at POST /v1/responses, so any agent built with the OpenAI SDK can access live product catalog data — with zero additional integration work.

Point your OpenAI agent at Catalogian's Responses endpoint, and it gets the same 14 tools available through MCP: browse schemas, filter products, query deltas, download snapshots, and more. The tools follow the OpenAI function calling format, so they work with any framework that speaks the OpenAI SDK — including the Agents SDK, Swarm, and custom implementations.

This is the fastest path from 'I have an OpenAI agent' to 'my agent can query live product data.' No MCP adapters needed, no custom tool definitions. Just point the SDK at the Catalogian endpoint and your agent has full catalog access.

Start monitoring free Read the docs

How it works

Configure the Catalogian Responses endpoint

Set your OpenAI client's base URL to catalogian.com/v1 and use your Catalogian API key. The /v1/responses endpoint speaks the OpenAI Responses format natively.

Agent discovers tools automatically

The 14 Catalogian tools are returned in OpenAI function calling format. Your agent sees tools like snapshot_schema, filter_snapshot_rows, and get_delta_rows — ready to call.

Query live product data

Your OpenAI agent can now ask questions about your product catalog. It calls Catalogian tools, gets structured data back, and reasons over it — all within the familiar OpenAI SDK flow.

OpenAI Agents SDK with Catalogian Responses API

from openai import OpenAI

client = OpenAI(
    base_url="https://catalogian.com/v1",
    api_key="cat_sk_live_..."
)

response = client.responses.create(
    model="catalogian",
    input="What products had price changes greater than 15% "
          "in the last week on my-catalog?",
    tools=[{"type": "function", "name": "auto"}]
)

# The agent calls get_delta_rows, filters for price changes,
# and returns a summary — all through the OpenAI SDK format

Frequently asked questions

Does this replace my OpenAI API key?

No. You use your Catalogian API key to access Catalogian's Responses endpoint. For LLM reasoning, the agent still uses your OpenAI API key. Catalogian provides the tools and data, not the model.

What's the difference between MCP and the Responses API?

MCP uses the Model Context Protocol (JSON-RPC over HTTP). The Responses API uses the OpenAI function calling format. Both expose the same 14 Catalogian tools. Use whichever your agent framework supports.

Can I use this with the OpenAI Agents SDK's Swarm pattern?

Yes. Catalogian's tools work with any framework that uses the OpenAI Responses API format, including Swarm, the Agents SDK, and custom agent loops built on the OpenAI Python/Node SDK.

Start monitoring your product feeds

Free plan includes 1 source and 50,000 SKUs. No credit card required.

Start monitoring free