@aria/openai-agents

ARIA MCP provider for the OpenAI Agents SDK. One factory call connects your Agent to mcp.aria.simplification.io — the same 21 tools and 6 Playbooks Claude Desktop sees, scoped to your org by your ARIA API key.

Install

pnpm add @aria/openai-agents

Usage

import { Agent } from "@openai/agents"
import { createAriaMCPProvider } from "@aria/openai-agents"

const aria = createAriaMCPProvider({
  apiKey: process.env.ARIA_API_KEY!,
})

const agent = new Agent({
  name: "ARIA customer-experience agent",
  mcp: [aria],
})

const result = await agent.run(
  "What's the one customer I should call right now?",
)

Options

| Option | Required | Default | Notes | | --- | --- | --- | --- | | apiKey | yes | — | Per-org ARIA API key. Generate at Settings → Integrations. | | endpoint | no | https://mcp.aria.simplification.io/mcp | Override for self-hosted or sandbox. | | name | no | aria | Friendly name surfaced inside the Agents SDK. | | extraHeaders | no | {} | Opt-in extra headers (tracing, etc). Cannot override Authorization. |

Honest hedges

• Bearer-token auth today. OAuth lands in v1.9.5.12.
• The provider is an HTTP transport configuration, not a runtime shim. We deliberately avoid a hard dependency on @openai/agents so this package stays small and forward-compatible across SDK minor versions.

Documentation

• Quickstart (TypeScript + Python)
• ARIA MCP marketing page

License

Proprietary — Simplification.io.