# EzUGC AGENTS.md

Instructions for coding agents using the EzUGC public API and MCP server. The GitHub repositories are private; this public copy is the discoverable version.

## Product

EzUGC generates UGC-style video ads, any-model videos, and static image ads (including Nano Banana) for paid-social teams. Generation requires a paid Startup, Growth, or Pro account.

## Authentication

Use a dashboard-issued API key (`ezk_live_`). Create one at https://app.ezugc.ai/dashboard/apps/mcp.

- `Authorization: Bearer ezk_live_...`
- or `x-api-key: ezk_live_...`

Walkthrough: https://www.ezugc.ai/docs/auth.md
RFC 9728 protected resource metadata: https://api.ezugc.ai/.well-known/oauth-protected-resource

There is no public OAuth authorization server, dynamic client registration, or trial key.

## Public API

- Base: https://api.ezugc.ai
- OpenAPI: https://api.ezugc.ai/openapi.json
- Docs: https://www.ezugc.ai/docs
- Developer portal: https://www.ezugc.ai/developers

Functional routes live under `/api/public/v1` (canonical) and `/api/public` (unversioned alias of v1). `GET /openapi.json` is unauthenticated documentation. Every generation route re-checks that the account is still paid. Breaking changes will ship as `/v2`; there is no `/v2` today.

## MCP

- Streamable HTTP: https://api.ezugc.ai/mcp
- stdio package: @ezugc/mcp
- Server card: https://www.ezugc.ai/.well-known/mcp/server-card.json
- Page: https://www.ezugc.ai/mcp

Set `EZUGC_API_KEY` for the stdio package. Remote HTTP uses the same key as a bearer token.

## Skills

Published Agent Skills index: https://www.ezugc.ai/.well-known/agent-skills/index.json

Hosted skills: ezugc-setup, ai-video-generation, ugc-generation, ezugc-brand-video, create-ugc-video, create-static-ad, ezugc-public-api.

Install with the skills CLI:

```
npx skills add https://www.ezugc.ai/.well-known/agent-skills/ai-video-generation/SKILL.md
npx skills add https://www.ezugc.ai/.well-known/agent-skills/ugc-generation/SKILL.md
```

## Hard rules

- Never invent a job, video, or image URL. Report the real API or MCP result.
- Never use app cookies or browser sessions for public API work.
- Never mention provider cost, USD per credit, or credit-to-dollar rates. Quota is remaining videos this billing cycle.
- Write Nano Banana with a space in user-facing copy.
- Do not claim an OAuth authorization server, sandbox, or unpublished endpoint.

Support: support@ezugc.ai