ElizaOS plugin for Operon - the protocol-level monetization layer for AI agents. Add quality-weighted sponsored placements to your agent's responses with zero prompt engineering.

How it works

The plugin runs a Provider that fires on every message. It sends the user's query to Operon's placement API, which runs a quality-weighted auction across registered advertisers. In v1, context fields (category, asset, intent) use sensible defaults - the Operon server handles matching and returns blocked when nothing fits. If a relevant, trustworthy service matches:

The sponsored recommendation is injected into your agent's context
Your agent naturally incorporates it into the response
The placement is logged as an impression

If nothing matches, the agent responds normally. No degradation, no empty ad slots.

Install

npx @elizaos/cli plugins add @operon/plugin-publisher-sdk

Or manually:

npm install @operon/plugin-publisher-sdk

Configure

Set your environment variables:

OPERON_URL=https://api.operon.so       # Operon network endpoint
OPERON_API_KEY=your-publisher-key      # Your publisher API key from Operon
OPERON_PUBLISHER_NAME=my-agent         # Optional - defaults to character name

TypeScript character

import operonPublisherPlugin from "@operon/plugin-publisher-sdk";

export const character: Character = {
  name: "MyResearchAgent",
  plugins: [operonPublisherPlugin],
  settings: {
    secrets: {
      OPERON_URL: process.env.OPERON_URL,
      OPERON_API_KEY: process.env.OPERON_API_KEY,
    },
  },
  // ...
};

JSON character

{
  "name": "MyResearchAgent",
  "plugins": ["@operon/plugin-publisher-sdk"],
  "settings": {
    "secrets": {
      "OPERON_URL": "https://api.operon.so",
      "OPERON_API_KEY": "your-publisher-key"
    }
  }
}

What your users see

When a sponsored placement fills:

[Sponsored] Relevant service available: Jupiter Aggregator

Best-rate DEX aggregation across Solana

Trust score: 82/100

When nothing matches, the response is clean - no mention of Operon or sponsorship.

Standalone SDK

If you want to use the Operon SDK outside ElizaOS:

import { createOperonPublisherSDK } from "@operon/plugin-publisher-sdk";

const sdk = createOperonPublisherSDK("https://api.operon.so", "your-key");
const result = await sdk.requestPlacement({
  publisher: "my-agent",
  slotType: "agent-response",
  requestContext: {
    query: "best way to swap ETH to USDC",
    category: "defi",
    asset: "ETH",
    amount: "5",
    intent: "swap",
  },
  responseContext: {
    actions: ["swap", "compare"],
    sentiment: "neutral",
  },
});