# YellowBus: AI agent guide

Insurance referrals for US consumers and lead subscriptions for licensed producers.

## Discover
- Service catalog: https://yllwbus.com/agent-api/services
- OpenAPI 3.1: https://yllwbus.com/agent-api/openapi.json
- MCP Streamable HTTP: https://yllwbus.com/mcp
- Sitemap: https://yllwbus.com/sitemap.xml
- Consumer education: https://yllwbus.com/money-101 and https://yllwbus.com/blog

## Request free quotes
Read https://yllwbus.com/agent-api/quote-requirements for required fields and the full current consent disclosure. Show that disclosure, contact preferences and request details to the consumer, and obtain explicit approval. POST the published schema to https://yllwbus.com/agent-api/quote-requests or call submit_quote_request in MCP. No consumer account or payment is required. A successful response is a referral receipt, not a quote, price, policy or guarantee of coverage. If human_action_required is returned, give the consumer continue_url and let them complete the real form/CAPTCHA. Never bypass CAPTCHA. Never automatically retry an uncertain submission. Newsletter enrollment is not included.

## Find leads and sign up as a producer
Read https://yllwbus.com/agent-api/producer-signup and https://yllwbus.com/agents. The real registration flow is https://yllwbus.com/portal/register. It accepts JSON with Accept: application/json and returns actionable continue_url responses; browser form signup is preferred for credentials. Keep the session cookie in a secure cookie jar, never in model text or URLs. Ask for explicit account-creation approval. Email verification, NPN/license checks, two-factor setup, location/insurance-line onboarding and human-confirmed paid checkout remain required. Follow each continue_url; do not say signup is complete or leads are active before those steps succeed. Private lead data and billing stay in the authenticated portal. Never harvest or enumerate leads.

## Policies
- Privacy and opt-out: https://yllwbus.com/privacy
- Terms: https://yllwbus.com/terms
- Support: https://yllwbus.com/contact
Consumers can stop contact using the private opt-out link in their confirmation email. Do not visit opt-out links while crawling.

## Platform boundaries
This custom Express site follows Shopify's public /agents.md discovery convention and exposes MCP and OpenAPI. It is not a Shopify store, does not advertise UCP checkout, and is not automatically listed in any AI chat directory. Connect an MCP-capable assistant to /mcp or import the OpenAPI contract into a compatible action client. Read-only web crawlers can discover the services and direct people to the signup forms.