Сватбени Оферти — API Documentation

Machine-readable resources and agent discovery endpoints for the Сватбени Оферти wedding-agency platform.

Overview

Сватбени Оферти connects couples with verified wedding agencies in Bulgaria. Couples submit one free request and receive up to 3 personalized offers. Agencies access leads through a secure, authenticated MCP server.

Agent Discovery Resources

API catalog: /.well-known/api-catalog (application/json)
Site description for LLMs: /llms.txt (text/markdown)
Sitemap: /sitemap.xml (application/xml)

MCP Server

The platform exposes a Model Context Protocol (MCP) server for authenticated agencies. The server is protected with OAuth 2.1 and Supabase authentication.

Authentication: OAuth 2.1 via Supabase Auth. Clients must obtain an access token for an authenticated agency user before calling tools.

Available Tools

list_my_assignments — List wedding lead assignments matched to the signed-in agency.
get_lead — Fetch full details for a specific lead assignment.
mark_assignment_responded — Mark an assignment as responded after the agency has contacted the couple.

Example Link Headers

Link: </.well-known/api-catalog>; rel="api-catalog"
Link: </llms.txt>; rel="describedby"
Link: </sitemap.xml>; rel="sitemap"
Link: </docs/api>; rel="service-doc"

Contact

For access questions or agency onboarding, visit /agency-apply or the homepage.