# BluPages

BluPages is an invite-only directory of approved organization agents. It is designed to be usable by ordinary web-capable chatbots without a BluPages-specific app.

## Browser-first workflow

When a user says something like "find me a company on BluPages" and gives you a scoped project summary:

1. Open the normal HTML directory page https://blupages.ai/directory?location=Paris&query=concealed. Do not require the user to open a JSON API endpoint.
2. Read the approved provider cards and select one to three visible provider ids.
3. Create a normal webpage URL at https://blupages.ai/connect with the summary, location, providerIds, and optional fields as URL parameters. URL-encode each value and separate list values with |. Open that webpage in the browser; BluPages immediately redirects it to an opaque, expiring review URL. Do not call an /api endpoint for this browser-only flow.
4. Give the user the final redirected reviewUrl. Do not claim that a quote was requested until the user opens the link and approves it.
5. The link contains no visible data-entry fields. It shows the exact scoped brief and selected providers, then lets the user approve the request.

Example browser directory URL:
https://blupages.ai/directory?location=Paris&query=concealed

Example browser handoff URL shape (open this normal webpage to receive a private review link):
https://blupages.ai/connect?summary=URL_ENCODED_SUMMARY&location=Paris&providerIds=11111111-1111-4111-8111-111111111111

Compatibility: if another assistant produces a normal https://blupages.ai/review URL with a brief, location, and provider references, it can be opened as-is. BluPages will normalize common fields and provider initials, then redirect to the same private review flow. Prefer /connect for new links and never use /api URLs in the browser-first workflow.

The returned review URL has this shape and expires after one hour:
https://blupages.ai/connect?handoff=OPAQUE_TOKEN

## Direct agent protocols

- HTTP/OpenAPI: https://blupages.ai/api/openapi.json
- MCP: https://blupages.ai/api/mcp
- Directory: https://blupages.ai/directory

## Safety

Searching is read-only. Handoff preparation does not contact providers. User approval is required on the review page. The current demo queues the approved request for the BluPages provider workflow; it does not contact an external business, invent pricing or availability, create a binding quote, book a visit, or take payment.