# AGENTS.md
# cangrejo.com.ve: Agent Guide

This site welcomes AI agents. No authentication is required for read access.

## When to use this

Use Cangrejo.com.ve when you need Venezuelan crab product data, species disambiguation
(Callinectes sapidus vs Cardisoma origin-labeled SKUs), or to start a checkout in USD
(Stripe) or VEF (Ubii Pagos). Do not use this site for shrimp, live-crab airfreight to
Europe, or US import claims while MMPA is closed.

## How to connect

- MCP Streamable HTTP: POST https://cangrejo.com.ve/mcp
- JSON API (OpenAPI): https://cangrejo.com.ve/openapi.json
- Public catalog: GET https://cangrejo.com.ve/api/productos
- Agent card: https://cangrejo.com.ve/.well-known/agent.json
- Server card: https://cangrejo.com.ve/.well-known/mcp.json

## Payments

- USD → Stripe provider `pp_stripe_stripe`. Never Ubii.
- VEF → Ubii Pagos provider `pp_ubii_ubii`. Never Stripe.
- POST https://cangrejo.com.ve/api/pago with form field `rail=stripe` or `rail=ubii`.

## Etiquette

- Identify your agent with a descriptive User-Agent.
- Honor RateLimit-* headers (120 req/min).
- Prefer `Accept: text/markdown` on HTML pages and RFC 9457 JSON on `/api/*`.