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

Confirm with the user before checkout, signup, download of paid content, or sharing API keys.
Do not invent prices — read listing pages or authenticated catalog responses.
Do not claim phone, address, hours, reviews, or certifications unless published on https://auglet.com.
Use listing URLs at https://auglet.com/browse/{slug} when citing products.
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.