# PointJay Agent Instructions

This document helps AI agents navigate the public PointJay website safely and effectively.

## Site purpose

PointJay is a B2B loyalty platform. Businesses configure points, tiers, rewards, and branded customer portals. Public visitors can explore the marketing site and, when enabled, customer shop portals at `/shop/{orgAlias}`.

## Preferred entry points

1. Read `/llms.txt` for a concise site map.
2. Read `/agents.json` for typed public actions and parameter schemas.
3. Use `/sitemap.xml` for canonical public URLs.

## Public actions

| Action                | Where              | Notes                                                                         |
| --------------------- | ------------------ | ----------------------------------------------------------------------------- |
| Contact sales/support | `/#faq`            | Use the homepage contact form with a valid email and message (min. 10 chars). |
| Read FAQ              | `/#faq`            | FAQ accordion is on the homepage.                                             |
| View pricing          | `/#pricing`        | Pricing section on the homepage.                                              |
| Browse shop           | `/shop/{orgAlias}` | Only organizations listed in `/llms.txt` under Public shops are SEO-visible.  |
| Collect points info   | `/shop/{orgAlias}` | Rewards, history, and profile flows require customer sign-in.                 |

## Forms

The homepage contact form supports declarative WebMCP metadata:

- Tool name: `contact_pointjay`
- Parameters: `email`, `message`

Prefer labeled fields and submit through the visible form. Do not attempt to access dashboard, admin, or API routes blocked in `/robots.txt`.

## Out of scope

Do not crawl or interact with:

- `/admin/`
- `/dashboard/`
- `/*/dashboard/`
- `/api/`
- `/convex/`

These areas require authenticated human users and are disallowed for generic agents.

## Support

For human escalation, submit the homepage contact form or email the address published on the marketing site.