MELINDA MARIA ×
Melinda Maria · Internal Tool Documentation

LoudCrowd Connector for Claude

A secure bridge that lets the team ask Claude plain-English questions about our LoudCrowd creator sales — revenue, orders, products, commission owed per creator, and a per-influencer leaderboard — with complete history kept for instant analysis.

READ-ONLY Version 5.0 · Live Google sign-in · MM staff only 11 tools + nightly sync 💸 Commission — LIVE (Aug 1)
✅ Status: Live in production (v5.0) at loudcrowd-mcp.melindamaria.ai/mcp. Reads LoudCrowd-attributed orders from Shopify, mirrors all 10,229 orders in a Cloudflare D1 database, refreshes nightly, and answers any range instantly — including the all-time influencer leaderboard. Update (Aug 1): commission is LIVE. The connector now syncs per-order commission dollars + attribution types nightly from LoudCrowd's official Brand API (released Jul 28), across both programs (Ambassadors + Creators): 2 new commission tools, and commission built into the summary and leaderboard. The connector is fully built for every data feed LoudCrowd has shipped; engagement & member data arrive when LoudCrowd releases those endpoints — see Limitations.
🔄 Already had LoudCrowd connected? Reconnect ONCE to unlock the new commission tools.

The v5 upgrade (Aug 1) replaced the old connector in place — same connector, same sign-in, nothing new to add. But Claude only refreshes a connector's tool list when you reconnect, so until you do, the two new commission tools stay invisible to you.

1 · In Claude, open Settings → Connectors and find LoudCrowd.
2 · Click Disconnect, then Connect again and sign in with your MM Google work account.
3 · Done — about 20 seconds. All 11 tools (incl. the commission report) appear automatically.

Connecting for the first time instead? Skip this — you'll get v5 automatically. Full steps in How to connect below.

1

Purpose

Why it exists

LoudCrowd is Melinda Maria's creator-commerce platform — it runs our ambassador, affiliate, and UGC programs and drives a meaningful slice of sales. (A "creator/ambassador platform" = the system that gives influencers tracked links and codes, then attributes the sales they drive.)

Until now, answering "which influencers are selling the most?" meant logging into LoudCrowd or waiting on their reporting. The connector removes that friction: anyone on the team can just ask Claude — "who are our top LoudCrowd creators this month?", "what did LoudCrowd drive last quarter?", "what's selling through our ambassadors?" — and get an instant, accurate answer.

It works by reading the orders LoudCrowd tags in Shopify (LoudCrowd stamps each ambassador order with the creator's handle), keeps a complete local copy so trend questions are instant, and never depends on a slow export.

👑

Who's selling the most

A real influencer leaderboard by creator handle — revenue and orders per person, ranked, for any time period.

💸

How much they're driving

Total revenue, order counts, and average order value — last 7 / 30 / 90 days, quarter-to-date, or all-time.

💎

What's selling

The exact products and SKUs moving through LoudCrowd, ranked by units — so you see the hero pieces.

Instantly, across all history

Its own cached database means even "all-time" answers come back in a second — no waiting, no timeouts.

2

How to connect & log in

For the team · live now

🔄 Connected before August 1, 2026? The v5 commission upgrade replaced the old connector in place — disconnect and reconnect once (Settings → Connectors → LoudCrowd) so Claude refreshes the tool list and picks up the two new commission tools. See the pink box at the top of this page for the 3-step version.

How to connect in three steps Open Settings then Connectors in Claude, find LoudCrowd and click Connect, then sign in once with your Google work account. Settings Profile Connectors Data controls 1 · Open Settings → Connectors MM LoudCrowdnot connected Connect 2 · Find it · click Connect you@melindamaria.com •••••••• Sign in ✓ 3 · Sign in once — done
David has already added LoudCrowd for the team — so you just Settings → Connectors → Connect → sign in with Google. One-time, ~1 minute. (Steps below cover it in detail.)
1

Open Claude → Settings → Connectors

In Claude (desktop or web), open Settings and go to Connectors. LoudCrowd is already loaded for the whole team — there is nothing to add and no URL to paste.

2

Find LoudCrowd and click Connect

Scroll to LoudCrowd in the connector list and click Connect. (Connected before Aug 1, 2026? Click Disconnect first, then Connect — that one-time refresh unlocks the v5 commission tools.)

3

Log in with Google

A Google sign-in opens. Choose your @melindamaria.com (or @7ate9.com) account. Any other domain is rejected. You never type a Shopify token or password.

4

Approve, then start asking

Approve the connection. To confirm it works, ask Claude to "run loudcrowd_health." Then ask anything from the use cases below — in plain English. Just include the word LoudCrowd.

🔑 What you'll never be asked to do

You will never enter a Shopify token, API key, or any credential into chat. Sign-in is your own Google account only. The connector holds the Shopify key internally and uses it on your behalf — read-only.

3

Scope

What's in / out

✅ In scope

Read LoudCrowd-attributed sales Influencer leaderboard Commission $ per creator (official API) Full-history mirror (10,229 orders) Trends & period compares SKU / product breakdowns Google login · MM-only

⛔ Out of scope

Creating / editing orders Changing anything in Shopify or LoudCrowd Engagement / ROAS metrics (LoudCrowd — not shipped yet) Member counts (LoudCrowd — not shipped yet) Any write action
11
Tools (all read-only)
10,229
Orders in the mirror
$164K
Lifetime LC revenue
$3,055
Commission tracked (since Apr '26)

The connector is read-only by design. Commission dollars now come from LoudCrowd's official Brand API (synced nightly, coverage from ~Apr 2026). Engagement metrics and member counts still live only inside LoudCrowd until they ship those endpoints — see Limitations.

4

Capabilities

What you can ask about
👑

Influencer leaderboard

Who's driving the most sales — revenue & orders per creator by their real handle, ranked, for any period. Unattributed sales reported separately and honestly.

💸

Headline sales

Total revenue, order count, average order value, paid vs. $0 comp orders — last 7 / 30 / 90 days, quarter-to-date, all-time, or custom. Now includes the period's commission total automatically.

🧾

Commission owed (NEW in v5)

What MM owes creators — per period, per creator, or per order — straight from LoudCrowd's official Brand API, with attribution types (tracked visit, link discount, etc.) and refund-adjusted amounts. Ask "how much commission do we owe this month, by creator?"

📊

Period-over-period

This month vs. last (or any 7/30/90-day window vs. the one before), with % change on revenue, orders, and active creators.

💎

Products & SKUs

Which products sold the most units through LoudCrowd — overall, or for one specific creator ("what does maymaytoldme sell best?").

📄

Order list & export

Every LoudCrowd order with date, value, channel, creator, and code — viewable, or dumped as rows for a spreadsheet.

Instant history

Backed by a local database, even all-time/lifetime questions answer in a second — no waiting, no timeouts.

4+

The full tool catalog

All 11 tools

You don't need to memorize tool names — just ask Claude in plain English and it picks the right one. This catalog is here so you know the full breadth. Everything is read-only.

📈 Reporting & analytics

loudcrowd_summary (revenue / orders / AOV / paid-vs-comp) · loudcrowd_top_creators (the influencer leaderboard, by handle + LoudCrowd id) · loudcrowd_compare (this period vs. previous, % change) · loudcrowd_sku_breakdown (top products by units) · loudcrowd_creator_products (one creator's best SKUs)

💸 Commission — NEW in v5 (official LoudCrowd data)

loudcrowd_commission (the commission report: totals, per-creator leaderboard, attribution + program breakdowns, refunds — for any period) · loudcrowd_order_commission (one order's official record: commission, attribution types, program, refund amounts)

📒 Order detail & export

loudcrowd_orders (individual orders: date, value, channel, code) · loudcrowd_export (raw rows for CSV / Sheets: order, date, revenue, creator, code, channel, SKUs)

🩺 System & diagnostics

loudcrowd_health (is it reading Shopify? how many tagged orders?) · loudcrowd_health_detail (exact query + page count, if a report looks off)

🌙 Behind the scenes (not a tool you call)

A nightly sync (Cloudflare Cron) refreshes the database automatically — the day's new/changed Shopify orders, then the commission sync from LoudCrowd's official Brand API (both programs, refund-adjusted). Every result is tagged source:"d1" (from the cache) or source:"shopify" (live fallback) so you always know where a number came from.

5

Limitations

What to know up front

It's a powerful tool, but a few things are worth knowing so you trust the numbers. Here they are in plain terms.

READ-ONLY

It can look, but it can't touch

The connector can answer questions and run reports, but it cannot change anything — it can't edit, cancel, or refund an order, or change anything in Shopify or LoudCrowd. That's on purpose, so it's completely safe to use.

WHO GETS CREDIT

Older sales often don't have a creator's name on them

For a sale to show a creator's name, LoudCrowd has to record that name on the order — and they only started doing this recently. So recent sales are well covered (about 8 in 10 name the creator), but older ones often aren't (about 4 in 10). The sales without a name still count in every revenue total — they just show up in an "unknown creator" group on the leaderboard, because the name was never recorded and can't be invented after the fact.

UNKNOWN-CREATOR SALES

Some real revenue can't be matched to a person

Across all time, about $83,500 of real sales has no creator name attached. Some are simply old (from before names were recorded); others were credited to a different program (like ShopMy or Impact) instead. This isn't an error — the connector always shows this "unknown" amount on its own so the totals stay honest.

HOW FAR BACK

Lifetime questions are instant; only a rare backup mode is limited

Because the connector keeps its own copy of every order, even "all-time" questions answer in a second. There's a backup mode that reads live from Shopify if that copy is ever unavailable — and that backup only goes back about 3,000 orders. In normal day-to-day use you'll never hit this.

HOW FRESH

Numbers refresh once a night

The connector updates its copy of the data every night (around 2am). So a sale from this afternoon shows up in totals tomorrow morning. If you need this-minute numbers, just ask for the "latest" or "live" figures and it checks Shopify directly.

COMMISSION COVERAGE

Commission is LIVE — but only back to ~April 2026

Update (Aug 1): commission dollars are now in the connector, synced nightly from LoudCrowd's official Brand API. One honest caveat: LoudCrowd's API only covers orders since our programs were created (~April 2026), so older orders in the lifetime mirror have no commission figures — that history simply doesn't exist at LoudCrowd's end. Social numbers (posts, impressions, sessions, ROAS) and member counts are still LoudCrowd-only until they ship those endpoints — the connector says so honestly rather than showing zeros, and they'll plug straight in when LoudCrowd releases them (nothing we built changes).

ATTRIBUTION COVERAGE

What creator attribution can — and can't — cover (quantified Aug 5, 2026)

Live-verified against the mirror: official attribution (commission $ + how the sale happened) exists only from April 2, 2026 — the day our programs were created; LoudCrowd's API has no earlier history. The link-vs-code channel split also only exists from around then: 98.9% of the 10,235 lifetime orders (June 2024 → today) carry no channel tag. Creator identity is better: 41% of lifetime orders carry a creator handle stamped at checkout — that's what powers the all-time leaderboard — but 59% (6,033 orders) have no creator or channel data at all. Plain rule: revenue totals are solid for any period; commission, channel-mix, and complete per-creator reports are only trustworthy from April 2026 onward. Every loudcrowd_summary answer now carries an attribution_coverage block saying exactly this.

GARBAGE IN, GARBAGE OUT

It's only as accurate as the tags on the orders

The connector trusts how LoudCrowd labels each order. If an order is mislabeled or missed, the report reflects that. Update (Jun 30): the empty "discount code" tag is not a gap — our ambassador program doesn't use affiliate codes, and LoudCrowd confirmed Shopify link-tagging already captures every LoudCrowd order. For anything high-stakes, still double-check against the source.

What's next from LoudCrowd

Future feeds · plug in when they ship

The connector is complete for every data feed LoudCrowd offers today — revenue, orders, products, the leaderboard, and (since Aug 1) official commission across both programs. Two more feeds are on LoudCrowd's roadmap; because the connector is a ready-made API client, each one plugs into the same nightly sync when it ships — no rebuild, nothing we built is wasted.

📈

Engagement & social metrics — waiting on LoudCrowd

Impressions, posts, reach, sessions, conversion rate, and ROAS will ship as a separate LoudCrowd endpoint (their timeline). Until then the tools say "not yet available from LoudCrowd" — never fake zeros.

👥

Member / roster data — waiting on LoudCrowd

Total members, new signups, active members (who posted), and purchasing members arrive as another endpoint after engagement.

Affiliate-code attribution — resolved by design

The LoudCrowd-Code tag is empty simply because our ambassador program doesn't use affiliate codes — LoudCrowd confirmed that Shopify link-tagging already captures every LoudCrowd-driven order. Codes aren't needed; this isn't a gap; no action required.

📌 The bottom line

Everything measurable today is measured: revenue, orders, products, the leaderboard, and commission. The two feeds above are LoudCrowd's to release — and the day they do, they slot straight in.

6

Best use cases & example prompts

Try these
1Leaderboard + payoutsSimple
Who are my top 10 LoudCrowd creators this month by revenue — and how much commission do we owe each of them?
2Headline numbersSimple
What did LoudCrowd drive over the last 30 days — revenue, orders, and total commission owed?
3Lifetime totalSimple
What's our all-time LoudCrowd revenue, and how much commission has accrued since the programs launched in April 2026?
4One creator, fullySimple
What does maymaytoldme sell best through LoudCrowd, and what's her commission for the quarter so far?
5Month vs. monthSimple
Compare LoudCrowd revenue AND commission this month vs. last month, with % change on both.
6Program split — NEWv5 · programs
Split this month's LoudCrowd results by program — Ambassadors vs. Creators: orders, revenue, and commission for each, and note which orders are attributed in both programs.
7Attribution mix — NEWv5 · attribution
How were this month's LoudCrowd orders attributed — tracked visits (LANDED) vs. automatic link discounts (LINK_DISCOUNT)? Show order counts and commission by attribution type.
8Refund-adjusted payouts — NEWv5 · refunds
Which LoudCrowd orders this month were refunded or exchanged, and how did that change the commission owed per creator? Show the before/after.
9One order's official record — NEWv5 · order lookup
Using LoudCrowd, look up order #1246235 — which creator gets credit, which program, how it was attributed, the commission amount, and any refunds against it.
10Commission payout sheet — NEWv5 · payouts
Build this month's LoudCrowd commission payout sheet: every creator with orders, gross attributed sales, refunds, and final commission owed — grouped by program (Ambassadors / Creators / both) — as a table I can export.
11Monthly recapClassic
Build a one-page LoudCrowd monthly recap: revenue, commission owed, top 5 creators, top 5 products, and how it compares to last month.
12RisersClassic
Which LoudCrowd creators drove sales this month but were quiet last month? Show me the risers.
13Thank-you DMsClassic
Take my top 10 LoudCrowd creators and draft each a short, on-brand thank-you DM I can personalize.
14Creator scorecardClassic
Build a scorecard for my top LoudCrowd creators: revenue, orders, AOV, commission earned, and each one's hero product.
15Channel shareClassic
How much of our total Shopify revenue last month came from LoudCrowd-attributed orders?
6+

Cross-connector use cases

LoudCrowd + your other tools

The real power shows up when a question spans tools — Claude pulls from each and stitches the answer together. These combine LoudCrowd with Shopify (DTC store), ShopMy (creator/affiliate sales), Klaviyo (email), Slack, Asana, Gmail, and Canva. You must have the relevant connector added. Tip: name both systems so Claude knows where to look.

16Weekly Slack leaderboardLC + Slack
Every Monday, pull last week's LoudCrowd top creators — revenue AND commission owed, split by Ambassadors vs. Creators program — and post the leaderboard to our Slack #marketing channel automatically.
17Live dashboardLC · artifact
Build a live dashboard page of LoudCrowd performance — revenue, leaderboard, top products — that refreshes whenever I open it.
18Email-flow gapLC + Klaviyo
Cross-reference LoudCrowd top creators with our Klaviyo list — which top sellers aren't yet in our ambassador email flow?
19Gifting tasksLC + Asana
For my top 20 LoudCrowd creators, create an Asana task each to send a gifting package — with their revenue, commission earned, program (Ambassador or Creator), and hero product in the notes.
20Big-sale webhookLC + Slack · code
Set up a webhook so when a LoudCrowd order over $300 comes in, it drops a celebratory note in Slack with the creator's name.
21Monthly recap automationLC + Gmail + Sheets
Monthly: compile a LoudCrowd recap PDF — revenue, commission owed by program, top creators, attribution mix — email it to the team as a Gmail draft, and log the numbers in a Google Sheet.
22Channel scorecardLC + Shopify + ShopMy
Build a last-quarter revenue scorecard across channels: LoudCrowd, ShopMy, and Shopify direct — with each channel's share and attribution overlap.
23Seasonality modelLC · analytics
Analyze 12 months of LoudCrowd data for seasonality — which months over-index, which creators peak when — and chart it.
24Creator search appLC · code
Build a small internal web app where the team can search any LoudCrowd creator and see their full sales history and products.
25Tiering modelLC · code + Canva
Create a creator-tiering model from LoudCrowd data (Gold/Silver/Bronze by revenue AND commission cost), build the monthly-refresh logic, and draft a tier one-pager for Canva.
🔗

20 multi-connector power workflows

v5 commission data × the whole stack

These go further: each one chains LoudCrowd's official commission & program data (new in v5) with several other connectors into a full workflow. Copy any of them straight into Claude — and name every system, like these do, so Claude knows where to look. Anything outbound (email, Slack, tasks) is drafted for your approval first.

26True-profit creator rankingLC + Shopify + ApparelMagic
Using LoudCrowd commission data, Shopify order values, and ApparelMagic product costs, rank my top 20 creators by TRUE profit after commission and refunds — who looks big on revenue but thin on margin?
27Payout reconciliation packLC + QuickBooks + Gmail
Build this month's LoudCrowd commission payout report by creator and program (Ambassadors / Creators / both), cross-check the totals against QuickBooks, and draft the finance-handoff email as a Gmail draft.
28Creator-platform overlap auditLC + ShopMy
Compare our LoudCrowd and ShopMy creator rosters: who drives sales on both, what does each platform's payout cost us per creator (LoudCrowd commission vs. ShopMy), and do any orders get claimed by both systems?
29Creator-order fulfillment watchLC + ShipHero
For every LoudCrowd-attributed order this week, check fulfillment status in ShipHero and flag anything unshipped after 3 days — creator-driven buyers talk to each other.
30Restock before the pushLC + ShipHero + Shopify
Take the top 10 SKUs LoudCrowd creators are selling this month, check current stock in ShipHero, and tell me what to reorder before the next Ambassadors-program push.
31CS issues on creator ordersLC + Gorgias
Find Gorgias tickets from customers whose orders were LoudCrowd-attributed this month — are creator-driven buyers hitting any recurring problem, and does it cluster on one product or creator?
32Refund-drain detectorLC + Loop
Cross-reference Loop returns with LoudCrowd commission adjustments: which creators' sales get returned most, how much commission was clawed back this quarter, and does any creator's return rate stand out?
33Ambassador-buyer email flowLC + Klaviyo
Build a Klaviyo segment of customers who bought through LoudCrowd creators in the past 90 days, and draft a "from our ambassadors" VIP email flow for them in MM's voice.
34First-commission onboardingLC + Asana + Gmail
Whenever a creator earns their first LoudCrowd commission, create an Asana onboarding task and draft a personalized congratulations email in Gmail with their first-sale stats and program details.
35Friday voice briefLC + ElevenLabs
Every Friday, summarize the week's LoudCrowd numbers — revenue, commission owed, top 3 creators, Ambassadors vs. Creators split — and generate a 60-second ElevenLabs voice brief for the team. (Heads up: ElevenLabs spends credits.)
36Creator-economy board deckLC + ShopMy + Shopify + PowerPoint
Make a quarterly creator-economy deck in PowerPoint: LoudCrowd vs. ShopMy revenue and payout cost, share of total Shopify revenue, top creators, and the monthly commission trend.
37Do creator visits convert?LC + Edgemesh
Compare Edgemesh site traffic and conversion data with LoudCrowd's LANDED (tracked-visit) attributions this month — do creator-driven sessions convert better than the site average?
38Repost → sales lift testLC + Sprout Social
Using Sprout Social post data, check whether creators' LoudCrowd sales spike in the 7 days after MM reposts them — which repost gave the biggest lift per commission dollar?
39Gifting ROI recapLC + Asana + Canto
For creators we gifted last quarter (from Asana gifting tasks), measure LoudCrowd sales and commission since the gift, compute the gifting ROI, and pull each winner's product shots from Canto for the recap.
40DTC vs. wholesale crossoverLC + NuOrder
Which products do LoudCrowd creators sell best DTC, and how does that ranking compare with what wholesale buyers order in NuOrder? Where should merchandising lean in next season?
41Commission milestone alertsLC + Slack
Set up a weekly Slack post: month-to-date commission owed by program, the single biggest commission order of the week, and any creator crossing $100 earned for the first time — celebrate them by name.
42Tiering on true costLC + ShopMy · code
Rebuild our creator tiers using both LoudCrowd and ShopMy: attributed revenue net of refunds, true payout cost (commission), and a suggested Gold/Silver/Bronze tier per creator with the math shown.
43Dormant-creator win-backLC + Klaviyo + Gmail
Find Ambassadors-program creators with no LoudCrowd sales in 60+ days who sold well before, check whether they're in our Klaviyo ambassador flow, and draft each a personalized win-back note in Gmail with their past earnings.
44Month-end commission accrualLC + QuickBooks
At month end, produce the LoudCrowd commission accrual — by program (Ambassadors / Creators / both), refund adjustments included, with the order-level detail attached — formatted for the QuickBooks journal entry.
45The everything pageLC + ShipHero + Klaviyo · artifact
Build me a live "creator commerce" page: LoudCrowd revenue + commission by program, fulfillment status of this week's creator orders from ShipHero, and revenue from our Klaviyo ambassador segment — refreshing every time I open it.
⚠︎

Warnings, limits & caveats

Read before relying on it
CROSS-CONNECTOR

Multi-tool answers need the other connectors

The cross-connector examples only work if you've added the other connector (Shopify, ShopMy, Klaviyo…) to your Claude. Matching records across systems relies on shared identifiers (creator handles, codes) being consistent — where they differ, Claude flags the ambiguity rather than guesses.

DRAFTS, NOT SENDS

Anything outbound is a draft first

When a prompt involves messaging (Slack, Gmail DMs to creators), Claude prepares a draft for your review — it won't send to people on its own. You approve before anything goes out.

MONEY FIELDS

Totals are computed on the fly

Revenue figures are summed from Shopify order data. For official accounting, treat Shopify (or the accounting system) as the source of truth — the connector reports attributed order value, not booked revenue.

ACCESS

Melinda Maria accounts only

Only @melindamaria.com and @7ate9.com Google accounts can connect. No public access. If someone leaves, removing their Google access cuts off the connector too.

7

Security analysis & risks

Trust & safety
Security posture in one line:

Read-only access · MM-staff-only login · the Shopify secret is never exposed · and the local data copy stays inside Melinda Maria's own Cloudflare account. Same hardened pattern as our other production connectors. None of the residual risks below are rated high.

LOW

Read-only blast radius

The connector cannot write, so a bug or misuse can't alter, cancel, or corrupt anything in Shopify or LoudCrowd. Worst case is reading data.

Mitigation: no write tools exist. Scopes are limited to read_orders + read_products.

LOW

Credential exposure

The Shopify Admin credential is powerful. If leaked, someone could read order data.

Mitigation: stored only as encrypted Cloudflare secrets (Client ID + Secret), used server-side, never sent to the browser or chat. The access token auto-expires every 24h and refreshes. Rotate in the Shopify Dev Dashboard anytime — the old one dies instantly.

LOW

Unauthorized access

Someone outside MM trying to connect and read company sales data.

Mitigation: Google OAuth with a strict email-domain allow-list (@melindamaria.com / @7ate9.com). Other domains are rejected at login. OAuth 2.1; encrypted session cookies.

MEDIUM

Everyone with a team login sees all sales data

There are no per-person limits inside the connector — any approved MM/7ate9 user can view the full leaderboard, revenue, and order export. Fine for an internal tool, but worth knowing before sharing widely.

Mitigation: access is gated to two company domains; treat connector access like access to a sales spreadsheet. Remove Google access when someone leaves. Consider limiting who you share the URL with.

MEDIUM

Local copy of business data (D1 mirror)

A complete copy of LoudCrowd order data — amounts, products, creator handles, discount codes — lives in a Cloudflare D1 database.

Mitigation: D1 sits inside MM's own Cloudflare account, reachable only through the authenticated connector (no public endpoint). It holds order facts only — no payment details, no full customer profiles. Treat the mirror as confidential company data; document who can access the Cloudflare account.

MEDIUM

Silent sync failure

If the nightly sync stops (token revoked, error), the mirror could quietly fall behind without anyone noticing.

Mitigation: each result is tagged source, and reports fall back to live Shopify if the cache is stale/empty, so answers stay correct. Recommended add: a freshness/uptime alert (we have the pattern from other connectors) so a stalled sync emails the owner.

INFO

Prompt-injection / data-as-instructions

Text in an order field (a note, a discount code) could in theory try to instruct Claude.

Mitigation: tools are read-only, so injected text can't trigger a write. Claude treats tool output as data, not commands. Low impact in a read-only design.

INFO

Rate-limit / availability

Heavy live querying could hit Shopify's API limits and slow responses.

Mitigation: the D1 mirror absorbs nearly all reads, a 30-min KV cache covers repeats, and live pulls retry with backoff and a page cap.

📌 At a glance
Name: loudcrowd-mcp · Access: read-only · Login: Google, MM domains only · URL: loudcrowd-mcp.melindamaria.ai/mcp · Hosting: Cloudflare (MM account) · Data: Shopify Admin API (LoudCrowd-tagged orders) + full-history D1 mirror + LoudCrowd Brand API (official commission, both programs, synced nightly) · Tools: 11 read-only + nightly sync · Delivered Aug 1: commission $ per order/creator (coverage ~Apr 2026 onward). Still coming from LoudCrowd: engagement/ROAS & member counts (later endpoints). Affiliate-code attribution resolved by design (program uses link-tagging, not codes).
8

What is a live artifact and how to share it

Build it once · it refreshes itself
📊 Live artifacts, dashboards & spreadsheets
📊 NEW — build live artifacts, dashboards & spreadsheets with this connector

A live artifact is a small interactive page Claude builds and saves for you — a dashboard, tracker, or report that pulls fresh data from this connector every time you open it, instead of being a frozen snapshot. In a Cowork session, just ask: “create a live artifact that…” — it lands in your Artifacts list, reusable forever, and its charts and tables refresh themselves on open.

Sharing with the team: artifacts are saved to your Claude account. Three easy ways to share: (1) ask Claude to export a snapshot (PDF, image, or .xlsx) and drop it in Slack; (2) send a teammate the prompt that built it — their copy fills with live data through their own connector sign-in; (3) for a permanent all-team dashboard, that’s the MM Intelligence project on the AI roadmap.

“Create a live artifact: a creator program dashboard — lifetime revenue, this month's orders and top creators, refreshed from LoudCrowd every open.”
LoudCrowd — live artifact
“Build a commission tracker artifact: accrued, refund-adjusted and pending commission by creator (v5 data), refreshed on open.”
LoudCrowd v5 — commission
“Make a spreadsheet (.xlsx) of this month's attributed orders with attribution type and commission per order.”
LoudCrowd — xlsx
“Build one artifact merging LoudCrowd and ShopMy into a single creator leaderboard with revenue bars.”
LoudCrowd + ShopMy
“Create an attribution-mix board artifact: tracked visit vs affiliate code vs link discount, trending weekly.”
LoudCrowd — attribution
9

Architecture

How it's built

The connector is a single Cloudflare Worker wearing four hats (v5): an OAuth 2.1 server (who can use it), an MCP server (what Claude calls), a Shopify reader (revenue backbone), and a LoudCrowd Brand-API reader (official commission + attribution, both programs) — backed by a KV cache and a D1 database, with a nightly cron that syncs orders first, then commission.

User & Claude Connector logic Storage & sync External systems
👤 MM team member
in Claude / Cowork — asks a question in plain English
asks a question
💬 Claude
MCP client — sends tools/call as JSON-RPC over HTTPS
OAuth 2.1 · secure handshake
☁️ Cloudflare Worker — loudcrowd-mcp.melindamaria.ai
MCP server endpoint /mcp · the connector's brain
🔐 Google login
email-domain allow-list (@melindamaria.com / @7ate9.com)
🧭 getOrders() router
D1-first, with live-Shopify fallback
🛍️ ShopifyClient
signs calls with the auto-refreshing token
reads & writes the local copy
⚡ KV cache
sessions + 30-min read cache + rotating token
🗄️ D1 database
full-history mirror — 10,229 orders + official commission table (v5)
🌙 Nightly sync
Cron ~2am PT · pulls the day's changes · no computer needed
HTTPS · read-only · token auth
🛍️ Shopify Admin API
reads orders tagged LoudCrowd
🔓 Google OAuth
verifies who you are at login
A REPORT REQUEST, STEP BY STEP
1
You ask a LoudCrowd question; Claude calls tools/call over HTTPS.
2
OAuthProvider checks your token; the tool handler runs.
3
getOrders() hits D1 first — a fast SQL read for the date range.
4
Rows re-hydrate into order shape, then summarize (revenue, leaderboard, SKUs…).
5
If D1 were empty, it falls back to live Shopify. Result tagged source.
THE NIGHTLY SYNC, STEP BY STEP
1
Cloudflare Cron fires scheduled() at ~2am — no laptop, no browser.
2
Reads last_sync from D1's lc_meta table.
3
Queries Shopify for orders updated_at ≥ last_sync — just the daily delta.
4
A safe UPSERT adds new + changed orders into lc_orders — without ever touching the v5 commission columns.
5
Advances last_sync. A missed night auto-catches-up next run.
6
Then the v5 commission sync runs: re-reads LoudCrowd's official Brand API (both programs — it's small, seconds), updates lc_commissions, and stamps the matching mirror rows. Each step has its own safety net, so one failing never blocks the other.

One reusable skeleton. Same proven pattern as our ShopMy & other connectors: a Cloudflare Worker that is its own login server, with one "client" module that knows how to read Shopify. The Shopify secret lives only inside the Worker — never in chat, never shown to users. One-time setup, not in the live path: a backfill.mjs script ran once on a Mac to seed all 10,141 historical orders (batched at 50/statement to stay under SQLite's size limit).

9+

The data story — how we capture & pull the history

Two layers, one database

All the history lives in one database (Cloudflare D1 — a small SQL database inside MM's own Cloudflare account) with two layers: a lifetime revenue backbone captured from Shopify, and the official commission layer captured from LoudCrowd's Brand API. The picture below is drawn to scale — see how far back each layer reaches, and why both exist.

How LoudCrowd data is captured and pulled Two sources feed one database: Shopify fills the lifetime order backbone back to July 2024; LoudCrowd's official API fills the commission layer from April 2026. Claude reads the database first, with a live Shopify backup. 🛍 Shopify Admin API every order Shopify tags "LoudCrowd" one-time backfill + nightly delta (~2am) 📡 LoudCrowd Brand API — official commission $ · attribution type · refunds · both programs nightly full re-read (tiny — takes seconds) captures REVENUE history captures COMMISSION truth 🗄 Cloudflare D1 — the connector's own database, inside MM's Cloudflare account lc_orders — the lifetime revenue backbone · 10,229 orders · $164K every LoudCrowd-tagged Shopify order · Jul 2024 → today · creators, SKUs, revenue ← pre-April-2026 history exists ONLY here (LoudCrowd's API can't see back that far) lc_commissions — the official commission layer · 250 orders · $3,055 → Apr 2026 → today · commission + attribution + refunds, per order, per program 🔗 matched to its backbone row by Shopify order ID Jul 2024 Apr 2026 · programs created today PULLING IT BACK OUT 👤 You ask Claude plain English · any date range ⚡ Database first — instant even "all-time" answers in about a second commission reads come from lc_commissions 🛟 Backup: live Shopify only if the mirror is unavailable reaches back ~3,000 newest orders Every answer is stamped with its source — "d1" (the mirror) or "shopify" (live) — so you always know where a number came from.
📥

How it got there

A one-time backfill script paged through Shopify's full order history to seed the backbone. Since then, a scheduled job (a "cron" — an automatic timer in Cloudflare's cloud, no computer needed) runs nightly at ~2am and adds only that day's new or changed orders. A watermark remembers where it left off, so a missed night self-heals.

💸

How commission stays true

Right after the Shopify step, the same nightly run re-reads LoudCrowd's official API end-to-end — it's small, so it takes seconds. That full re-read is deliberate: if a refund months later claws back a creator's commission, we catch it. Each API order is matched to its backbone row by Shopify order ID.

How you pull it

Ask Claude anything — tools read the database first, so even lifetime questions answer in about a second. If the mirror were ever unavailable, a live-Shopify backup covers the newest ~3,000 orders. Every result names its source, so the numbers are always traceable.

📌 Why two layers (the honest asymmetry)

Each layer sees things the other can't. The backbone holds ~10,000 orders from before April 2026 that LoudCrowd's API will never return. The commission layer attributes ~140 program-era orders that carry no LoudCrowd tag in Shopify — invisible to the backbone. Keeping both, joined by order ID, is what makes the connector's answers complete: lifetime revenue from one, official payout truth from the other.

Onboarding Hub v3.03 · 📕 Download entire documentation (PDF) · 🤖 Docs as Markdown (.zip)· MELINDA MARIA × CLAUDE ·← Back to all connectors