Uud (Oud & Incense)

Uud (Oud & Incense) — connector documentation

• MCP endpoint: https://uud.connectorbay.com/mcp
• REST API: POST https://uud.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://uud.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://uud.connectorbay.com/health · Tool schemas: https://uud.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/uud · agent@connectorbay.com

Uud (Oud & Incense)

What Uud is for

Two related Arab sensory-culture traditions live behind one confusing shared name: "oud" is both a musical instrument (a pear-shaped fretless lute) and a fragrance material (also called agarwood) — two completely unrelated things that happen to share the same English transliteration. Uud is a hand-curated, fully local reference that answers questions about both, and is careful to say clearly, every time, which one it means.

What it does

The oud instrument's construction, parts (bowl body, soundboard, pegbox, strings), typical string count and tuning approaches, as a factual instrument reference (instrument_info); what bakhoor incense is and how it is traditionally burned over charcoal in a mabkhara or majmar, with hospitality customs (bakhoor_guide); agarwood/oud as a fragrance material — what it is, its forms, origin regions and grading terminology, with no pricing and no medicinal claims (agarwood_oud_info); traditional non-alcohol perfume-oil (attar) culture and its common note families, including an accurate treatment of the musk note — today essentially always synthetic or plant-based, not animal-derived (attar_perfume_guide); mabkhara and majmar incense-burner types, materials and regional styles (burner_types_guide); when bakhoor/incense is traditionally used — welcoming guests, weddings, Eid, or everyday use (occasion_guide); about a dozen glossary terms clearly split between the instrument sense and the fragrance sense of "oud" (oud_family_glossary); general oud-instrument care basics and incense-offering etiquette as a guest (care_and_etiquette_guide); and a free-text search across every entry (search).

What it is not

Not a retailer, appraiser, marketplace or health resource. Uud never states a price, and it makes no medicinal, therapeutic or health claims about agarwood or any other material it describes — agarwood/oud is covered strictly as a fragrance material and historical trade good. It also does not duplicate maqam theory or playing theory, which the Nagham (Melody) connector already covers in depth for the oud instrument and the broader instrument family; nor does it cover Arab wedding traditions themselves, which the Zafaf (Wedding) connector covers — Uud only covers the incense/fragrance dimension of those celebrations. Fully local and keyless: nothing is fetched from any upstream source and nothing about a query is stored.

Tools

Instrument

instrument_info — The oud (instrument)'s construction, parts (bowl body, soundboard, pegbox, strings), typical string count and tuning approaches — a factual instrument reference. Not to be confused with oud/agarwood, the fragrance material (see agarwood_oud_info). For maqam theory and playing theory, see the Nagham connector. Use for "what are the parts of an oud", "how many strings does an oud have", "how is an oud tuned".

Incense & burners

bakhoor_guide — What bakhoor incense is, how it is traditionally burned (over charcoal in a mabkhara or majmar), and the hospitality and occasion customs around it. Use for "what is bakhoor", "how do you burn bakhoor", "why do people burn incense for guests".

burner_types_guide — Mabkhara and majmar incense-burner types, materials and regional styles (wood, ceramic, metal, electric, and Maghrebi-style burners). Use for "what's a mabkhara", "what's the difference between a mabkhara and a majmar", "what are incense burners made of". Args: burner.

Fragrance

agarwood_oud_info — Agarwood/oud as a fragrance material — what it is, its forms (chips and oil), origin regions, and grading terminology. No pricing, no medicinal or therapeutic claims. Not to be confused with the oud musical instrument (see instrument_info). Use for "what is agarwood", "where does oud oil come from", "what does oud grading mean".

attar_perfume_guide — Traditional non-alcohol perfume-oil (attar) culture and its common traditional note families — rose, oud, amber and musk-type notes — including an accurate note that traditional "musk" today is essentially always synthetic or plant-based, not animal-derived. Use for "what is attar", "is musk in perfume from an animal", "what notes are used in traditional Arab perfume".

Occasions & care

occasion_guide — When bakhoor/incense is traditionally used for a given occasion — welcoming guests, weddings (see the Zafaf connector for the wedding traditions themselves), Eid, or everyday use. Use for "when do people burn incense for guests", "is incense used at weddings", "do people burn bakhoor for Eid". Args: occasion.

care_and_etiquette_guide — General oud-instrument care basics (storage, cleaning, strings, tuning pegs) and incense-offering etiquette for a guest. Use for "how do I take care of an oud", "what do I do if a host offers me incense".

Reference

oud_family_glossary — Definitions of about a dozen core terms, clearly split between the oud instrument's vocabulary (risha, pegbox, course) and the oud/agarwood fragrance vocabulary (bakhoor, mabkhara, dahn al-oud). Use for "what does dahn al-oud mean", "what's a risha", "what's the difference between oud the instrument and oud the fragrance". Args: term.

search — Search across every reference entry — the instrument, bakhoor, agarwood/oud fragrance, attar, burner types, occasions, glossary terms and care/etiquette guidance. Use for a broad query that does not map cleanly onto one specific tool, e.g. "musk", "hospitality", "Gulf incense burner". Args: query.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/uud/support

Uud (Oud & Incense) — Privacy Policy

Effective 24 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Uud is. Uud (Oud & Incense) is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated, fully local reference on the oud musical instrument and traditional Arab incense/perfume culture: bakhoor, agarwood/oud oil, attar, and mabkhara/majmar incense burners. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup.

What we receive. The arguments of each tool call — a burner type, an occasion, a glossary term, or a search query — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is answered from bundled, hand-curated reference files and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire dataset is bundled with the server and answered locally. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Uud is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Uud (Oud & Incense) — Terms of Service

Effective 24 September 2026. These terms govern use of the Uud (Oud & Incense) connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Uud (Oud & Incense) returns a hand-curated, fully local reference on the oud musical instrument and traditional Arab incense/perfume culture — bakhoor, agarwood/oud oil, attar, and mabkhara/majmar incense burners. It is accessed through an AI assistant or directly over MCP or HTTP.
2. A reference, not a marketplace or health resource. Uud is an independent factual and cultural reference tool, not a retailer, appraiser, marketplace, or health or medical resource, and is not affiliated with or endorsed by any brand, seller or government body. It never states a price for any product or material and makes no medicinal, therapeutic or health claims about agarwood or any other material it describes. For purchasing, appraisal or health guidance, consult an appropriate specialist or vendor instead.
3. A hand-curated reference. Content reflects general, widely-documented cultural, historical and craft-reference knowledge as curated at build time; it is not a substitute for expert appraisal, luthiery advice or professional guidance, and regional customs vary and continue to evolve beyond what is captured here.
4. Acceptable use. Automated use within the published rate limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: your query is answered from bundled reference files, and nothing is stored.
7. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
8. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
9. Governing law. California law; venue in San Mateo County, California.
10. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/uud

Uud (Oud & Incense) support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://uud.connectorbay.com/mcp
• REST API: https://uud.connectorbay.com/openapi.json
• Live status: https://uud.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Uud (Oud & Incense) never asks for them.