Endlss

Map of everything this Endlss MCP server can do, partitioned into what THIS key can use vs. what it can't (missing scope). Call this FIRST when you're unsure which tools exist or where to start — it returns the capability areas (sellers, orders, gifts, offers, invites, messages, Inbox, creator discovery, sequences, analytics, UGC, ad campaigns, partnership ads, content submissions, payouts), the business concept behind each, the tools in it, and — for areas the key lacks the scope for — the exact scope to enable. Also returns a recommended workflow for the common 'reward my top creators' loop. This is metadata only; it makes no backend calls and is always available.

Create a favorite list. Optionally link it to a sequence so future additions auto-enroll creators into that sequence.

Invite a NEW creator onto the brand's roster (the recruitment entry point — gifts and offers only work for creators already on the roster). Sets their tier/commission/discount terms and optionally sends the invite email immediately (send=true). Default confirm=false runs the backend dry-run validation path without creating anything; pass confirm=true to actually create the invite. Use when: onboarding a creator who isn't a seller yet. Don't use when: the person is already on the roster (gift/offer/message them directly).

Create a draft offer using the Django MCP offer write shape. This does not send it. Default confirm=false echoes the request payload locally WITHOUT hitting the server — no server-side validation runs, so a payload that's missing required fields or has bad enum values won't surface until confirm=true. Show the echoed payload to the user, then call again with confirm=true to actually persist the draft.

Create a new sequence. Default confirm=false echoes the payload locally WITHOUT hitting the server (no server-side validation runs at preview time). Re-run with confirm=true to actually create.

Create a step inside a sequence. `order` is required. Default confirm=false echoes the payload locally WITHOUT hitting the server (no server-side validation at preview time). Re-run with confirm=true to actually create the step.

Create a new message template. Uses the Django MCP serializer field names. By default returns the request preview locally; pass confirm=true to actually create.

Read the brand's Creator Match feed — Endlss's own ranked feed of suggested creators to recruit. Free (no credits). Returns candidates with ranking score, top evidence, and dismissed/restored status. Use when: you want curated creator suggestions without spending credits — the cheap first stop before endlss_search_creators. Don't use when: you want roster creators (use endlss_list_sellers).

Delete a favorite list. This does not delete the favorites themselves.

Delete an offer template. Irreversible; offers already created from it are unaffected. Refused with `offer_template_in_use` (and the `sequences` that use it) while a non-archived workflow has a send_offer step using the template — that step would silently stop working. Point those steps at another template (endlss_update_sequence_step seller_offer_template_id) or archive the workflows first. Default confirm=false returns a local preview; confirm=true deletes.

Delete a sequence.

Delete one step from a sequence.

Delete a template. By default returns a preview; pass confirm=true to actually delete. Deletes are irreversible.

Dismiss a Creator Match candidate so it stops appearing in the active feed. Idempotent. The candidate can be restored later with `endlss_restore_candidate`.

Create a new draft as a copy of an existing offer. Default confirm=false returns a local preview WITHOUT hitting the server. Re-run with confirm=true to actually duplicate.

Enroll one or more creators into a sequence. Set start_immediately=true only when the API key also carries messages:send.

Mark a creator as a favorite for the brand. Returns the favorite row.

Fetch one activity by id, including its resolved `target` (the order/gift/offer/etc. it refers to). Use when: you have an activity id from the feed and want its full detail.

Load this brand's stored AI context document (brand identity, program strategy, AI operating preferences, and the inline 'Learned Observations' memory). Returns { exists, content, updated_at }. Call this FIRST at the start of every session: if exists is false the brand has no context yet — run the brand-context skill to create one. The context persists across sessions and platforms, so a returning brand should not be re-interviewed.

Fetch the full profile report for a single creator on a given platform. Cached per-brand, so a second call for the same creator is free (`credits.used_this_request: 0`, `fetched_from_cache: true`). First-time fetches consume credits.

Fetch one gift by id, including its full `products` line items (name, quantity, discount, variants), recipient, status, and message. This is the endpoint to reach for after spotting a gift in an activity feed (the activity's `target` block carries the gift id) to answer 'what was in this creator's last gift?'. Use when: you have a gift id and want its contents — e.g. before restocking. Don't use when: you only have a creator and want their gift history (call endlss_list_gifts with brand_seller_id).

Fetch one curated gift bundle by id, including its products. Use when you have a bundle id and want to preview exactly what would ship before calling endlss_send_gift with that `gift_bundle_id`.

Fetch one invite by id, including its status, recipient, tier/commission terms, and redemption state. Use when: you have an invite id from endlss_list_invites and want its full detail.

Fetch one outbound message by id, including its rendered content and delivery status. Use when: you have a message id from endlss_list_messages and want its full detail.

Fetch one offer by id, including its full contract: deliverables, licensing, payment terms, and status. Use when: you have an offer id and want its detail before editing/sending/duplicating it.

Fetch one offer template by id: name, offer_type (+ label), description and its `defaults` (the offer field values an offer created from it starts with).

Fetch one seller (roster creator) by id, returning the full detail object: profile, tier, social handles, commission, address, and lifetime totals, plus `ad_performance` — the creator's lifetime partnership-ad figures (grants_count, active_grant, ads_count, live_ads_count, spend_cents, purchase_value_cents, purchases, roas, earnings_cents, last_delivery_date) in `currency` minor units (roas null without spend). Use when: you have a brand-seller id (e.g. from endlss_list_sellers or an activity) and want their full profile before gifting, messaging, or making an offer.

List UGC posts for ONE creator by brand-seller id — the brand-related content a specific seller has posted. Cursor-paginated. Convenience over endlss_list_ugc when you already have the brand-seller id. Use when: reviewing a single creator's content (e.g. before gifting or making an offer).

Fetch a single sequence by id, with its steps. send_offer steps carry `seller_offer_template` {id, name, offer_type} and `template_missing` (true = no template attached; enrollments stall on that step).

Fetch aggregate analytics for a single sequence.

Fetch one enrollment from a sequence.

Fetch one pending sequence response draft.

Fetch one step from a sequence.

Fetch one message template by id, including its subject, body, type, and variables. Use when: you have a template id and want its content. To see it rendered for a creator, use endlss_preview_template.

Gifting ROI per creator — the brand app's Gifting report 'Top performing creators' table. One row per creator who received a gift in the date range: `orders_count` and `total_revenue` (sales attributed to the gift — non-gift orders they drove after accepting a gift in the prior 90 days), `gift_cost` (what the gifts sent to them cost), and `roi` (total_revenue / gift_cost; null when gift_cost is 0). The response's `summary` carries the report totals the rows add up to (gifts sent/accepted, orders, revenue, gift cost, ROI). Money is a 2dp string in `currency`. Use when: 'which gifted creators paid off?', 'who should we restock?', 'which gifts were wasted?' (sort by `roi` ascending, or look for orders_count 0). Don't use when: you want a creator's gift contents (endlss_list_gifts) or all-sales leaderboards regardless of gifting (endlss_analytics_overview / endlss_list_orders).

Find the most relevant Endlss Help Center article for a natural-language question. Returns the article title and URL when a keyword match is found, or the Help Center home URL with matched=false when nothing matches. Pure local lookup; no external call.

List the seller activity stream — the chronological feed of things creators did or had done to them: orders placed, gifts sent/accepted, commission payments, offers, applications, invites. Cursor-paginated. Every row carries a `target` block (kind + id + summary) you can drill into — e.g. a gift activity's target id is the gift id you pass to endlss_get_gift. `performed_by` ({id, name}) names the brand team member who took the action — who accepted an application, sent a payment or wrote a note — and is null for creator- or system-driven activity (orders, auto-accepted applications). Use when: you want a timeline of what's happening — 'which creators just placed orders?', 'what was this creator's last gift?', 'who on our team accepted this creator's application?'. Don't use when: you want aggregate totals (use endlss_activity_summary) or the full object behind a target (call the matching get tool, e.g. endlss_get_gift / endlss_list_orders). Filters: type (csv of activity types), brand_seller_id, since, until, target_kind.

List the brand's favorite creators. Read-only; does not consume credits.

List the brand's favorite lists. Lists can optionally auto-enroll creators into a linked sequence when favorites are added.

List the brand's curated gift bundles (reusable product templates), newest first (cursor-paginated). A gift bundle is a predefined set of products the brand can drop on any creator — the 'restock with a *different* gift' source. Each bundle exposes its products so you can preview contents. Use when: the operator wants to send a creator a standard package rather than copying a past gift. Don't use when: you want gifts already sent to creators (call endlss_list_gifts). To actually send a bundle, pass its id as `gift_bundle_id` to endlss_send_gift.