# Auglet agent integration guide

Guide for developers and AI agents connecting to Auglet via MCP or REST.

## Canonical URLs

- Website: https://auglet.com
- MCP server: https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/mcp-server
- REST API base: https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/api-v1
- API documentation: https://auglet.com/docs/api.md
- OpenAPI: https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/api-v1/openapi.json
- Manifest: https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/api-v1/manifest
- Health: https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/api-v1/health
- Human MCP setup page: https://auglet.com/mcp
- A2A Agent Card: https://auglet.com/.well-known/agent-card.json
- A2A integration page: https://auglet.com/agents
- A2A endpoint (5 public skills, including `ask_auglet_agent`): https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/a2a

## A2A (Agent2Agent)

Auglet publishes an A2A Agent Card at `/.well-known/agent-card.json`. Public discovery skills (`get_business_profile`, `ask_about_auglet`, `ask_auglet_agent`, `browse_catalog_index`, `get_contact_options`) are callable via `POST https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/a2a` without an API key. Authenticated skills require API keys.

A plain-text JSON-RPC `message/send` with no `skillId` is routed to `ask_auglet_agent` (a grounded assistant over published Auglet sources). If model credentials are unavailable, it falls back to the deterministic `ask_about_auglet` corpus. Neither skill performs purchases, downloads, or account reads — those require the authenticated skills below (and human approval for checkout).

See https://auglet.com/agents for request examples and skill matrix.

## Authentication tiers

| Access | Auth required | Examples |
|--------|---------------|----------|
| Server health & discovery | **No key** | `health_check`, MCP `resources/list`, REST `GET /health`, `GET /manifest` |
| Catalog read | **API key** with `listings:read` | MCP `list_listings`, `get_listing`, `semantic_search_assets`; REST `GET /listings` |
| Owned assets | **API key** with `assets:read` / `assets:write` | MCP `list_assets`, `create_asset`; REST asset endpoints |
| Purchases & downloads | **API key** with `purchases:read` | MCP `list_purchases`, `get_purchase_download` |
| Checkout | **API key** with `checkout:create` | REST `POST /checkout` |

Mint API keys in **Creator Studio → API Console** (https://auglet.com/creator/api-console). Keys are shown once at creation.

## MCP tools (public vs protected)

| Tool | Scope |
|------|-------|
| `health_check` | public |
| `get_business_profile` | public |
| `list_services` | public |
| `get_contact_options` | public |
| `check_service_area` | public |
| `ask_business_question` | public |
| `list_listings` | listings:read |
| `get_listing` | listings:read |
| `semantic_search_assets` | listings:read |
| `list_assets` | assets:read |
| `get_asset` | assets:read |
| `create_asset` | assets:write |
| `update_asset` | assets:write |
| `list_orders` | orders:read |
| `list_purchases` | purchases:read |
| `get_purchase` | purchases:read |
| `get_purchase_download` | purchases:read |
| `export_asset_zip` | purchases:read or assets:read |
| `get_asset_package_manifest` | assets:read or listings:read |
| `get_asset_package_tree` | assets:read or listings:read |
| `get_asset_package_file` | assets:read or purchases:read (paid) |
| `submit_feedback` | feedback:write |

## MCP resources (no key for list/read via resources/list)

- `marketplace://manifest`
- `marketplace://categories`
- `marketplace://scopes`
- `marketplace://fulfillment-types`

## Agent behavior rules

1. **Confirm with the user** before checkout, signup, download of paid content, or sharing API keys.
2. **Do not invent** prices — read listing pages or authenticated catalog responses.
3. **Do not claim** phone, address, hours, reviews, or certifications unless published on https://auglet.com.
4. **Use listing URLs** at `https://auglet.com/browse/{slug}` when citing products.
5. Catalog discovery requires a `listings:read` key — do not assume anonymous catalog access.

## Support

yourindie101@gmail.com

## Related static files

- /llms.txt — short index
- /llms-full.txt — extended briefing
- /mcp/SKILL.md — agent skill
- /business/index.json — structured business resources
- /faq.md — marketplace FAQ
- /policies.md — policy summary

## Ask API (no MCP required)

POST https://fjozfegsxseblmpplcrb.supabase.co/functions/v1/ask-business with `{"question":"..."}` — deterministic FAQ answers with sources.