---
title: "AIOD Developer Platform: API & MCP"
canonical: "https://www.aiodapp.com/developers/"
description: Connect AI agents to AIOD through a versioned discovery API and OAuth-protected MCP server for Shopify discount workflows.
---

AIOD provides a public, versioned REST discovery API and an OAuth-protected MCP server for Shopify discount workflows.

## Public discovery

Use GET /api/v1/health, GET /api/v1/agent-capabilities, /openapi.json, /.well-known/api-catalog, /.well-known/ard.json, and /.well-known/mcp/server-card.json without an API key. Request /?mode=agent for a compact JSON view.

## MCP authentication and safety

Connect to https://aiod-automatic-discount.com/mcp using Streamable HTTP. Store access uses OAuth 2.1 with PKCE and the aiod:discounts scope. Drafts create nothing in Shopify; test-mode publishing cannot make a discount live, and the MCP server cannot delete discounts.

## Agent skill and plugin

AIOD publishes a reusable Agent Skill and Agent Plugin bundle at https://www.aiodapp.com/agent-plugin/aiod-discounts/. Its source is available at https://github.com/ivijayc47/aiod-website/tree/main/public/agent-plugin/aiod-discounts.

## Versioning and deprecation

Stable discovery endpoints use a major URL version beginning with /api/v1/. Breaking changes use a new major path. Scheduled retirements are signaled with standardized Deprecation and Sunset response headers.