# Agent Instructions for OptiComm.AI

> This file is for autonomous AI agents (browser agents, coding agents, crawlers).
> Last updated: 2026-04-26

## Identity

OptiComm.AI — Execute. Automate. Scale..
The closed-loop intelligent commerce platform. Predict demand. Decide intelligently. Act autonomously. Deploy dedicated AI agents for every employee and every customer.

## Quick Facts

- Canonical URL: https://agents.opticomm.ai
- Contact: contact@opticomm.ai
- API: https://agents.opticomm.ai/.well-known/openapi.json
- MCP manifest: https://agents.opticomm.ai/.well-known/mcp.json
- Sitemap: https://agents.opticomm.ai/sitemap.xml
- LLM context: https://agents.opticomm.ai/llms.txt (summary) and https://agents.opticomm.ai/llms-full.txt (detail)

## What this site does

- **Predict**: 50+ deep learning models for demand forecasting, churn prediction, and revenue optimization.
- **Decide**: AI-powered pricing, inventory optimization, and autonomous decision-making with human override controls.
- **Act**: Autonomous AI agents across Voice, WhatsApp, Email, and API. 380+ agents deployed in 30+ languages.

## Recommended interaction modes

| Goal | Use this | Don't |
|------|----------|-------|
| Read product info | `https://agents.opticomm.ai/llms-full.txt` | Scrape rendered HTML |
| Call platform programmatically | OpenAPI: `https://agents.opticomm.ai/.well-known/openapi.json` | Reverse-engineer XHR |
| Use tools (catalog, KB, DNC) | MCP servers in `https://agents.opticomm.ai/.well-known/mcp.json` | Direct DB access |
| Try an agent live | Visit `https://agents.opticomm.ai/create-agent` | n/a |

## Safe-to-call public endpoints

- `GET https://agents.opticomm.ai/llms.txt` — site summary (text/plain)
- `GET https://agents.opticomm.ai/llms-full.txt` — full context (text/plain)
- `GET https://agents.opticomm.ai/agents.md` — this file (text/markdown)
- `GET https://agents.opticomm.ai/sitemap.xml` — sitemap (application/xml)
- `GET https://agents.opticomm.ai/.well-known/mcp.json` — MCP server manifest (application/json)
- `GET https://agents.opticomm.ai/.well-known/openapi.json` — OpenAPI contract

## Prerendered HTML for crawlers (recommended for non-JS bots)

For a fully-semantic, JavaScript-free HTML representation of any public route,
append the route path to the prerender endpoint:

- Index: `GET https://wwryungezqbhcsywzwei.supabase.co/functions/v1/ai-discovery/prerender` — JSON list of all prerenderable routes
- Per-route: `GET https://wwryungezqbhcsywzwei.supabase.co/functions/v1/ai-discovery/prerender{path}` — e.g. `/predict`, `/solutions/airbnb`
- Static mirrors: `https://agents.opticomm.ai/prerender/{slug}.html` (sitemap-discoverable)

These pages contain the canonical title, description, inline JSON-LD, and a
`<link rel="canonical">` back to the live SPA URL. Use these instead of
scraping the React shell.

## Note on DNC compliance

DNC (Do-Not-Call) compliance is intentionally NOT exposed as an MCP server.
Honor verbal opt-outs via the dedicated webhook: `POST https://wwryungezqbhcsywzwei.supabase.co/functions/v1/dnc-webhook-tool`
with header `x-dnc-secret: <DNC_WEBHOOK_SECRET>`. See `https://agents.opticomm.ai/llms-full.txt` for payload details.


## Authentication

- Marketing pages: no auth required.
- Platform API: Bearer JWT (Supabase auth) + `x-company-id` header for tenant scope.
- MCP servers: per-server auth listed in the MCP manifest.

## Fair use

- Public discovery endpoints have a 5-minute CDN cache (`Cache-Control: public, max-age=300, s-maxage=600`). Please honor `If-None-Match` for ETag-based revalidation.
- Authenticated API: per-plan limits, surfaced in `X-RateLimit-*` headers when applicable.

## AI training policy

See `https://agents.opticomm.ai/ai.txt` for the explicit allow/disallow list of URL prefixes
that may be used for AI model training. Disallowed paths emit `X-Robots-Tag: noai, noimageai`.

## Things agents must NOT do

1. Do not submit forms on behalf of unauthenticated users (signup, checkout, contact).
2. Do not bypass authentication by harvesting session cookies.
3. Do not call MCP servers without a valid `x-company-id` header — requests fail closed.
4. Do not store or republish user-specific data scraped from authenticated views.
5. Do not place outbound calls/messages via the platform without an explicit user mandate
   recorded in the relevant campaign record.

## Available MCP servers

### Product Catalog MCP

- Slug: `mcp-product-catalog`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-product-catalog
- Scopes: catalog:read
- Auth: header:x-company-id
- Query product catalog by SKU, category, attributes. Returns price, stock, and metadata.

### Knowledge Base MCP

- Slug: `mcp-knowledge-base`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-knowledge-base
- Scopes: kb:read
- Auth: header:x-company-id
- Semantic search over company knowledge base documents (RAG).

### Discovery MCP

- Slug: `mcp-discovery`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-discovery
- Scopes: public:read
- Auth: none
- Public OptiComm.AI positioning, pillars, capabilities, industries, compliance, contact, and live plans/pricing. No auth required — designed for external AI agents.

### Platform Catalog MCP

- Slug: `mcp-catalog-public`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-catalog-public
- Scopes: public:read
- Auth: none
- Lists OptiComm.AI's MCP servers, REST API endpoints, third-party integrations, and public discovery surfaces. Lets agents understand what the platform exposes.

### Demo MCP

- Slug: `mcp-demo`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-demo
- Scopes: demo:write
- Auth: none
- Trigger a live AI voice demo call from any external agent. IP rate-limited (1 call per IP per hour).

### Status MCP

- Slug: `mcp-status`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-status
- Scopes: public:read
- Auth: none
- Public health and reachability of OptiComm.AI's discovery surfaces and MCP servers. Useful for agent observability.

### Pricing & Plans MCP

- Slug: `mcp-pricing-and-plans`
- URL: https://wwryungezqbhcsywzwei.supabase.co/functions/v1/mcp-pricing-and-plans
- Scopes: public:read, lead:write
- Auth: none
- List plans, compare features, estimate cost for a target usage, and submit a quote request. Lead-capture surface for buying agents. Quote requests rate-limited to 5 per IP per hour.

## Compliance posture

- ISO 27001 (Information Security)
- ISO 42001 (AI Management Systems)
- ISO 20000 (Service Management)
- ISO 9001 (Quality Management)
- GDPR compliant
- EU AI Act ready
- Data residency: AWS Frankfurt (eu-central-1)

## Updates

This file is generated from the site content registry and refreshed on every deploy.
Dynamic, always-current version: `https://wwryungezqbhcsywzwei.supabase.co/functions/v1/ai-discovery/agents.md`