The Omazy Plugin SDK lets you ship MCP-compatible plugins that any business on Omazy can install — to connect their internal tools, expose private APIs to AI agents, or automate workflows that don't fit a stock integration.
TWO AUDIENCES
Whether you're shipping a plugin to thousands of workspaces or wiring up a private one for your own business — same SDK, same runtime.
Build once. Every Omazy workspace becomes a customer. Omazy handles auth, billing, signing, rate limits — you focus on the integration.
Already on Omazy but need it to talk to your in-house CRM, ERP, or internal API? Build a private plugin in days — install it like any marketplace plugin.
PLUGIN ANATOMY
Eleven component types. Pick the ones you need — declare them with decorators on a Python module.
Functions the AI agent calls: shopify.search_products, crm.lookup_account. Pydantic input schemas, billable meters.
Read-only addressable data: shopify://products/{id}. Streamed into agent context on demand.
Text fragments appended to the agent system prompt when the plugin is active. Scoped per channel or always-on.
@plugin.on_webhook(topic="order.created") — react to events from the downstream system or from Omazy core.
Cron-driven reconcile jobs. Pull product catalog, reindex inventory, refresh customer attributes.
Lifecycle: on_install, on_uninstall, on_activate. Provision OAuth, write defaults, clean up on removal.
Buttons in the workspace UI: 'Sync now', 'Reconnect'. Operators trigger them; you handle the call.
Prebuilt RFC 2202 chains shipped with the plugin — workspace operators install them as starting points.
5-MINUTE QUICKSTART
Scaffold a plugin, register a tool, run it locally, hit it from the dev-omazy CLI. Five minutes if you've got Python + Docker installed.
Step 1
uv run omazy-plugin new my-pluginStep 2
from omazy_plugin_sdk import Plugin
plugin = Plugin(slug="my-plugin", version="1.0.0", scopes=["my-plugin:read"])
@plugin.tool(
name="my.search",
description="Search the customer's catalog",
billable_meter="tool_call",
)
async def search(ctx, query: str, limit: int = 5) -> dict:
return {"results": [...] }
app = plugin.fastapi()Step 3
docker compose up dev-omazy
uv run --package omazy-plugin-my-plugin uvicorn my_plugin.main:app --port 8082Step 4
uv run dev-omazy call \
--target http://localhost:8082/tools/call \
--tool my.search \
--args '{"query":"hello"}'When you're ready to publish, submit the listing to omazy.com/marketplace/submit. Review takes ~3 business days.
Get early access →RUNTIME ARCHITECTURE
Omazy signs every request, records every event, enforces every scope. You return a result.
Workspace agent triggers a tool call
intent → harness picks tool → enqueues call
MCP gateway signs + forwards
JWT signed with per-vendor key · scope checked · rate limit applied
Vendor plugin handles the call
your FastAPI app · uses vendor-stored creds · returns JSON
Usage event recorded, response streamed back
billing meter increments · trace stored · agent continues loop
Vendor-hosted
You run the plugin on your infra. Omazy never executes vendor code.
Cred isolation
Downstream OAuth tokens (Shopify, etc.) live in your storage, never Omazy's.
Replayable
Every call is in the Omazy trace store — debug from a customer ticket, not from your logs alone.
TRUST + BILLING
Every Omazy → plugin request carries a JWT signed with a per-vendor key. Reject unsigned, you can't get spoofed.
The agent can only call tools the workspace explicitly allowlisted. Capabilities are the security perimeter, not prompts.
Omazy handles billing, taxes, refunds, and payouts. Monthly transfer to your connected Stripe account.
Per-vendor rate limits and a circuit breaker protect both sides. A misbehaving plugin can't take down the workspace.
OPERATOR USE CASES
Plugins aren't only for the marketplace. The same SDK powers private plugins that extend a single workspace.
Wrap your internal /orders, /customers endpoints as a plugin. Your AI agent calls them with the same scope checks and audit trail as any first-party tool.
Salesforce / HubSpot are stock. Your in-house CRM isn't. Build a 200-line plugin that exposes lookup, create, update — and your operators get it as a normal integration.
Insurance claim triage, multi-warehouse inventory routing, in-house compliance check. If it's specific to your business, it's a plugin.
EARLY ACCESS · BETA
Drop your email and tell us what you want to build. We'll fast-track the first 50 plugin authors with vendor onboarding, signing keys, and a direct line to the SDK team.
You're on the list.
We'll email you when your access is ready.